ScrapeField

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.
LinkedIn	18	Profiles, companies, search, posts and jobs.
Instagram	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 with requests.

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: support@scrapefield.com.

License

MIT: use the skill and the examples as you like. See LICENSE.