herascrape-mcp
v0.1.0
Published
MCP server for the herascrape Instagram API — connect Claude, Cursor, and other agents to herascrape.
Maintainers
Readme
herascrape-mcp
Instagram data for AI agents, over the Model Context Protocol. Point Claude, Cursor, ChatGPT, VS Code, or any MCP client at herascrape-mcp and it can read public Instagram profiles, content, engagement, and search results directly — no scraping code, no browser, no login.
Every endpoint is one tool, generated from the live API, so the tool list never drifts from what the server serves. It is read-only, cursor-paginated, and flat $0.0004 per successful call (only 2xx is billed). Powered by the herascrape Instagram API.
What agents can do with it
- Profiles & audiences — resolve a username or user id to a full profile; page a user's followers and following; pull the "about" / account details.
- Content — a user's posts, reels, tagged posts, live stories, highlights, and reposts; fetch any individual post or reel by id.
- Engagement — read a post's comments and their replies; see who liked a post or a comment.
- Discovery — hashtag top / recent / reels; a location's top & recent media; trending audio and the clips using a given audio track.
- Search — users, hashtags, audio, places, and a universal "top" search.
- Utilities — resolve a shortcode or URL to a media id, oEmbed a post, and check your live balance.
Agents reach for these when a task needs what's actually on Instagram right now — audience research, competitor and campaign tracking, influencer vetting, trend and hashtag analysis, enriching a profile or a post.
Install — one click
The button above opens a client picker and installs herascrape-mcp wherever you run agents. For clients with native one-click install:
Get an API key (or sign in to authorize in-browser) from your herascrape dashboard.
Install — manual
Remote (recommended) — connect by URL, authorize in the browser
Hosts that support remote MCP connect to the hosted server and authorize with a click (OAuth); no key to copy.
Claude Code:
claude mcp add herascrape --transport http https://herascrape.com/mcpCursor / Claude Desktop / ChatGPT:
{ "mcpServers": { "herascrape": { "url": "https://herascrape.com/mcp" } } }
Local (stdio-only hosts) — run the bridge from source
Only needed for hosts that cannot connect to a remote MCP server. The bridge is
a thin stdio-to-HTTP proxy to the hosted server: it forwards your API key as
x-api-key and relays the live tool list and calls — it defines no tools of its
own. It is not published to a package registry; clone and build it (Node ≥ 18):
git clone https://github.com/herascrape/herascrape-mcp && cd herascrape-mcp
npm install && npm run buildThen point your client at the built entry, with an API key from your dashboard:
{
"mcpServers": {
"herascrape": {
"command": "node",
"args": ["/abs/path/to/herascrape-mcp/dist/index.js"],
"env": { "HERASCRAPE_API_KEY": "your_key" }
}
}
}Configuration
| Variable | Default | Purpose |
| --- | --- | --- |
| HERASCRAPE_API_KEY | — | Sent as x-api-key. Required when running the bridge from source. |
| HERASCRAPE_MCP_URL | https://herascrape.com/mcp | Override the server URL (e.g. staging). |
License
MIT
