Skip to content

feat: replace username+password with single base64 token #44

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
domantas-jurkus-dcd merged 3 commits into from
Apr 24, 2026
Merged

feat: replace username+password with single base64 token #44

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
a818e96
feat: version 1.1.0
domantas-jurkus-dcd Apr 23, 2026
14ad7b6
feat: replace user+pass with base64 token
domantas-jurkus-dcd Apr 24, 2026
a21252d
Add tests
domantas-jurkus-dcd Apr 24, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .env.example
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,2 +1,5 @@
DECODO_SAPI_HOST=https://scraper-api.decodo.com

SCRAPER_API_TOKEN=<token>

ENABLE_MCPS_LOGGER=false
48 changes: 33 additions & 15 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,14 +20,16 @@ services, streamlining access to our tools and capabilities.
- Simple integration. Seamless setup with popular MCP clients like Claude Desktop, Cursor, and
Windsurf.

## Connecting to [Decodo's MCP server](https://mcp.decodo.com/mcp)
## Authenticating

1. Go to [decodo.com](https://decodo.com/scraping/web) and start a Web Scraping API plan (free plan
available).

2. Once your plan has started, obtain a Web Scraping API basic authentication token from the
[dashboard](https://dashboard.decodo.com/).

## Connecting to [Decodo's MCP server](https://mcp.decodo.com/mcp) (Claude Code, Cursor)

3. Open your preferred MCP client and add the following configuration:

```
Expand All @@ -41,6 +43,23 @@ services, streamlining access to our tools and capabilities.
}
```

## Claude Desktop

```
{
"mcpServers": {
"Decodo MCP Server": {
"command": "npx",
"args": ["@decodo/mcp"],
"env": {
"SCRAPER_API_TOKEN": "<web_scraping_api_base64_token>",
"TOOLSETS": "web,ai"
}
}
}
}
```

## Running the MCP server locally

<details>
Expand Down Expand Up @@ -90,8 +109,7 @@ this:
"command": "node",
"args": ["/Users/your.user/projects/decodo-mcp/build/index.js"],
"env": {
"SCRAPER_API_USERNAME": "your_username",
"SCRAPER_API_PASSWORD": "your_password"
"SCRAPER_API_TOKEN": "<web_scraping_api_base64_token>"
}
}
}
Expand Down Expand Up @@ -133,31 +151,31 @@ The server exposes the following tools:
| `scrape_as_markdown` | Scrapes any target URL, expects a URL to be given via prompt. Returns results in Markdown. | Scrape peacock.com from a US IP address and tell me the pricing. |
| `screenshot` | Captures a screenshot of any webpage and returns it as a PNG image. | Take a screenshot of github.com from a US IP address. |
| `google_search` | Scrapes Google Search for a given query, and returns parsed results. | Scrape Google Search for shoes and tell me the top position. |
| `google_ads` | Scrapes Google Ads search results with automatic parsing. | Scrape Google Ads for laptop and show me the top ads. |
| `google_lens` | Scrapes Google Lens image search results with automatic parsing. | Search Google Lens for this image: https://example.com/image.jpg |
| `google_ai_mode` | Scrapes Google AI Mode (Search with AI) results with automatic parsing. | Ask Google AI Mode: What are the top three dog breeds? |
| `google_ads` | Scrapes Google Ads search results. | Scrape Google Ads for laptop and show me the top ads. |
| `google_lens` | Scrapes Google Lens image search results. | Search Google Lens for this image: https://example.com/image.jpg |
| `google_ai_mode` | Scrapes Google AI Mode (Search with AI) results. | Ask Google AI Mode: What are the top three dog breeds? |
| `google_travel_hotels` | Scrapes Google Travel Hotels search results. | Search Google Travel Hotels for hotels in Paris. |
| `amazon_search` | Scrapes Amazon Search for a given query, and returns parsed results. | Scrape Amazon Search for wireless keyboard. |
| `amazon_product` | Scrapes Amazon Product page with automatic parsing. | Scrape Amazon product B09H74FXNW and show me the details. |
| `amazon_pricing` | Scrapes Amazon Product pricing information with automatic parsing. | Get pricing for Amazon product B09H74FXNW. |
| `amazon_sellers` | Scrapes Amazon Seller information with automatic parsing. | Get information about Amazon seller A1R0Z7FJGTKESH. |
| `amazon_bestsellers` | Scrapes Amazon Bestsellers list with automatic parsing. | Show me Amazon bestsellers in electronics. |
| `amazon_product` | Scrapes Amazon Product page. | Scrape Amazon product B09H74FXNW and show me the details. |
| `amazon_pricing` | Scrapes Amazon Product pricing information. | Get pricing for Amazon product B09H74FXNW. |
| `amazon_sellers` | Scrapes Amazon Seller information. | Get information about Amazon seller A1R0Z7FJGTKESH. |
| `amazon_bestsellers` | Scrapes Amazon Bestsellers list. | Show me Amazon bestsellers in electronics. |
| `walmart_search` | Scrapes Walmart Search for a given query, and returns parsed results. | Scrape Walmart Search for camping tent. |
| `walmart_product` | Scrapes Walmart Product page with automatic parsing. | Scrape Walmart product 15296401808. |
| `walmart_product` | Scrapes Walmart Product page. | Scrape Walmart product 15296401808. |
| `target_search` | Scrapes Target Search for a given query, and returns parsed results. | Scrape Target Search for kitchen appliances. |
| `target_product` | Scrapes Target Product page with automatic parsing. | Scrape Target product 92186007. |
| `target_product` | Scrapes Target Product page. | Scrape Target product 92186007. |
| `tiktok_post` | Scrapes a TikTok post URL for structured data (e.g. engagement, caption, hashtags). | Scrape this TikTok post: https://www.tiktok.com/@nba/video/7393013274725403950 |
| `tiktok_shop_search` | Scrapes TikTok Shop Search for a given query, and returns parsed results. | Scrape TikTok Shop Search for phone cases. |
| `tiktok_shop_product` | Scrapes TikTok Shop Product page. | Scrape TikTok Shop product 1731541214379741272. |
| `tiktok_shop_url` | Scrapes TikTok Shop page by URL. | Scrape this TikTok Shop URL: https://www.tiktok.com/shop/s?q=HEADPHONES |
| `youtube_metadata` | Scrapes YouTube video metadata. | Get metadata for YouTube video dFu9aKJoqGg. |
| `youtube_channel` | Scrapes YouTube channel videos with automatic parsing. | Scrape YouTube channel @decodo_official. |
| `youtube_channel` | Scrapes YouTube channel videos. | Scrape YouTube channel @decodo_official. |
| `youtube_subtitles` | Scrapes YouTube video subtitles. | Get subtitles for YouTube video L8zSWbQN-v8. |
| `youtube_search` | Search YouTube videos. | Search YouTube for "How to care for chinchillas". |
| `reddit_post` | Scrapes a specific Reddit post. | Scrape the following Reddit post: https://www.reddit.com/r/horseracing/comments/1nsrn3/ |
| `reddit_subreddit` | Scrapes Reddit subreddit results with automatic parsing. | Scrape the top 5 posts on r/Python this week. |
| `reddit_subreddit` | Scrapes Reddit subreddit results. | Scrape the top 5 posts on r/Python this week. |
| `reddit_user` | Scrapes a Reddit user profile and their posts/comments. | Scrape this Reddit user: https://www.reddit.com/user/IWasRightOnce/ |
| `bing_search` | Scrapes Bing Search results with automatic parsing. | Search Bing for laptop reviews. |
| `bing_search` | Scrapes Bing Search results. | Search Bing for laptop reviews. |
| `chatgpt` | Search and interact with ChatGPT for AI-powered responses and conversations. | Ask ChatGPT to explain quantum computing in simple terms. |
| `perplexity` | Search and interact with Perplexity for AI-powered responses and conversations. | Ask Perplexity what the latest trends in web development are. |

Expand Down
Loading
Loading