English Français العربية

herascrape

Official registry Search and web

Instagram data over MCP: profiles, posts, reels, stories, highlights and search as JSON

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http herascrape 'https://herascrape.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "herascrape": {
            "type": "http",
            "url": "https://herascrape.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. herascrape-mcp
  2. What agents can do with it
  3. Install — one click
  4. Install — manual
  5. Configuration
  6. License

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

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

VariableDefaultPurpose
HERASCRAPE_API_KEY—Sent as x-api-key. Required for the local bridge.
HERASCRAPE_MCP_URLhttps://herascrape.com/mcpOverride the server URL (e.g. staging).

License

MIT

Frequently asked questions

What is herascrape?

Instagram data over MCP: profiles, posts, reels, stories, highlights and search as JSON

How do I install herascrape?

It runs as a remote server. In Claude Code: claude mcp add --transport http herascrape 'https://herascrape.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does herascrape need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is herascrape open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains herascrape?

It is published by herascrape. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.