About ScrapeField
ScrapeField provides Google Maps, LinkedIn, Instagram, TikTok, and X data through a REST API and tools for AI agents. Its remote MCP server offers 45 platform-specific endpoints, with demo responses available without an API key.
Key features
- 0145 platform-specific endpoints
- 02Google Maps and social platform data
- 03Demo mode without an API key
- 04Documented response formats and call costs
Use cases
- 01Retrieve place details, reviews, and photos
- 02Look up social profiles, posts, and jobs
- 03Test API calls using fixed demo responses
MCP support
A remote MCP server at `https://scrapefield.com/mcp` exposes every API endpoint as a tool. It supports demo mode without a key and offers a `sign_up` tool.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://scrapefield.com/mcpclaude mcp add --transport http com-scrapefield-scrapefield https://scrapefield.com/mcp{"mcpServers":{"com-scrapefield-scrapefield":{"type":"http","url":"https://scrapefield.com/mcp"}}}Open in Cursor{"servers":{"com-scrapefield-scrapefield":{"type":"http","url":"https://scrapefield.com/mcp"}}}Open in VS Code{"mcpServers":{"com-scrapefield-scrapefield":{"type":"http","url":"https://scrapefield.com/mcp"}}}{"mcpServers":{"com-scrapefield-scrapefield":{"serverUrl":"https://scrapefield.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://scrapefield.com/mcpAuth requiredTools
47| Parameter | Type | Required | Description |
|---|---|---|---|
| lat | number | No | Latitude of the point to search around. |
| lng | number | No | Longitude of the point to search around. |
| fresh | boolean | No | Skip the cache and fetch now. Charged normally. Not available on trial credits — buy any pack to unlock it. |
| limit | integer | No | At most this many results, 1–20. A page can hold fewer while `next_cursor` is set: read until it is null. |
| query | string | Yes | What to search for, e.g. "coffee shops in Brooklyn" or "dentist". |
| cursor | string | No | The `meta.next_cursor` from the previous page. Omit for the first page. |
| country | string | No | Two-letter country code to bias results, e.g. `us`. |
| language | string | No | Two-letter language code for localised text, e.g. `en`, `de`. |
| radius_m | integer | No | Search radius in metres around lat/lng. |
Details
From the project READMEScrapeField
Google Maps, LinkedIn, Instagram, TikTok and X data through one REST API, and as tools for AI agents. 45 endpoints, each platform's data in its own documented shape, and a published credit cost for every call. Blocks are handled for you: no proxies to rotate, no CAPTCHAs to solve, no browser to run.
This repository holds the agent skill, the MCP server's setup and examples. The API itself is at scrapefield.com.
Try it with no key
curl "https://api.scrapefield.com/v1/google-maps/place?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&demo=true"
Add demo=true to any endpoint: one fixed answer in the real shape, charged nothing, no account.
For real answers, get a key at scrapefield.com and send it as Authorization: Bearer sf_live_….
Platforms
| Platform | Endpoints | What you get |
|---|---|---|
| Google Maps | 5 | Places, details, reviews, photos and posts. |
| 18 | Profiles, companies, search, posts and jobs. | |
| 6 | Profiles, posts, comments and hashtags. | |
| TikTok | 8 | Profiles, videos, comments and search. |
| X | 8 | Profiles, posts, replies and search. |
For AI agents: the MCP server
A remote MCP server at https://scrapefield.com/mcp (streamable HTTP). Every endpoint is a tool. With no key it runs in demo
mode, and its sign_up tool asks the user for an account by email.
Claude Code:
claude mcp add --transport http scrapefield https://scrapefield.com/mcp \
--header "Authorization: Bearer sf_live_…"
A client that reads mcp.json:
{
"mcpServers": {
"scrapefield": {
"type": "http",
"url": "https://scrapefield.com/mcp",
"headers": { "Authorization": "Bearer sf_live_…" }
}
}
}
The setup for each client: Claude Code, Cursor, Codex, VS Code, Claude, ChatGPT.
The registry entry is mcp/server.json.
The agent skill
skills/scrapefield/SKILL.md tells a coding agent when to reach for the API, when
not to, and the traps. For Claude Code, copy the folder into .claude/skills/ in your project or in your home
folder. For Cursor, save the file as a rule in .cursor/rules/. The current version is always at scrapefield.com/skill.md.
Examples
examples/typescript: Node 22.18 or later, which runs TypeScript as it is; no packages.examples/python: Python 3 withrequests.
Each folder has demo, which needs no key, and live, which reads your key from SCRAPEFIELD_KEY.
Documentation
- Docs and errors
- llms.txt and llms-full.txt: the whole API for a model, in one fetch
- OpenAPI
- Pricing and status
Questions: [email protected].
License
MIT: use the skill and the examples as you like. See LICENSE.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.