herascrape
Instagram data over MCP: profiles, posts, reels, stories, highlights and search as JSON
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http herascrape 'https://herascrape.com/mcp'
{
"mcpServers": {
"herascrape": {
"type": "http",
"url": "https://herascrape.com/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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/mcp - Cursor / Claude Desktop / ChatGPT:
{ "mcpServers": { "herascrape": { "url": "https://herascrape.com/mcp" } } }
Local — npx, with an API key
For hosts that only run local (stdio) servers. Needs Node ≥ 18.
- Claude Code:
claude mcp add herascrape --env HERASCRAPE_API_KEY=your_key -- npx -y herascrape-mcp - Claude Desktop / Cursor (
claude_desktop_config.json/.cursor/mcp.json):{ "mcpServers": { "herascrape": { "command": "npx", "args": ["-y", "herascrape-mcp"], "env": { "HERASCRAPE_API_KEY": "your_key" } } } }
The local bridge is a thin stdio-to-HTTP proxy to the hosted server: it forwards
your key as x-api-key and relays the live tool list and calls. It defines no
tools of its own.
Configuration
| Variable | Default | Purpose |
|---|---|---|
HERASCRAPE_API_KEY | — | Sent as x-api-key. Required for the local bridge. |
HERASCRAPE_MCP_URL | https://herascrape.com/mcp | Override the server URL (e.g. staging). |
License
MIT
Questions fréquentes
Qu'est-ce que herascrape ?
Instagram data over MCP: profiles, posts, reels, stories, highlights and search as JSON
Comment installer herascrape ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http herascrape 'https://herascrape.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour herascrape ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
herascrape est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient herascrape ?
Il est publié par herascrape. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.