chocodata-mcp

MCP server for the Chocodata web scraping API. Gives Claude, Cursor, Cline, Continue and any other MCP-compatible client tools to scrape the web, so an agent can pull live product prices, search results and social profiles without you writing glue code.

Runs over stdio. Node 18+.

Setup

Add it to your client's MCP config. It runs on demand via npx, so there is no global install and no version drift:

{
  "mcpServers": {
    "chocodata": {
      "command": "npx",
      "args": ["-y", "chocodata-mcp"],
      "env": { "CHOCODATA_API_KEY": "asa_live_YOUR_KEY" }
    }
  }
}

Get a key at chocodata.com. The free tier is 1,000 requests, one time, no card.

Claude Desktop: claude_desktop_config.json. Cursor: Settings, then MCP, then Add. Restart the client after editing, then ask it something like "what does this Amazon ASIN cost in Germany?"

Tools

| Tool | What it does | |---|---| | amazon_product | One product by ASIN/ISBN (query) or url. Prices localise to domain. | | amazon_search | Amazon search results. | | walmart_product | One item by url or id. | | walmart_search | Walmart search results. | | ebay_product | One listing with ISO currency, stock status, quantity sold/available. | | ebay_search | eBay search results. | | bing_search | Web results. Good for grounding an answer in current sources. | | bing_images | Image results with source pages. SafeSearch strict by default. | | tiktok_profile | Public profile with follower/like/video counts. | | youtube_video | Title, exact view and like counts, duration, channel. | | instagram_profile | Public profile: followers, bio, post count, verified. | | scrape | Any of the 499 endpoints, for anything above not covered. |

Parameters follow the API's real contract rather than a uniform invention: amazon_product takes query, walmart_product takes url or id, and the Bing tools take q. Each tool's schema documents its own parameters, so the agent picks the right ones.

The generic tool

scrape reaches everything else in the catalog:

target:   "reddit"
resource: "post"
params:   { "post_id": "627akk", "subreddit": "askscience" }

Browse every target and its parameters at chocodata.com/scraper-api.

Errors

Failures come back as readable tool errors rather than stack traces, and say whether retrying will help:

Chocodata error 404 item_not_found: That TikTok handle does not resolve:
it has been deleted, renamed, or is unavailable in this region.
Request id: d2f460a7-...

You are only charged on a 2xx. Errors cost no credits. Retryable failures (429, 5xx, network) are retried automatically with backoff before the agent ever sees them.

Rate limits

120 requests per key per 60 seconds, plus a per-plan concurrency ceiling. An agent looping over many items can hit that; the server backs off and retries rather than failing the whole tool call.

License

MIT