instagram-data-mcp 0.1.0__tar.gz

instagram_data_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write   # PyPI trusted publishing: no API token stored anywhere
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: python -m pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

instagram_data_mcp-0.1.0/.gitignore

@@ -0,0 +1,3 @@
+dist/
+__pycache__/
+*.egg-info/

instagram_data_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FastSocial
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

instagram_data_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.5
+Name: instagram-data-mcp
+Version: 0.1.0
+Summary: MCP server for public Instagram data: profiles, posts, reels, stories, highlights, comments, hashtags and more.
+Project-URL: Homepage, https://fastsocial.co/instagram-api
+Project-URL: Documentation, https://fastsocial.co/instagram-api/docs
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai-agents,claude,instagram,instagram-api,mcp,model-context-protocol,scraper
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Requires-Dist: anyio>=4
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=2.2
+Description-Content-Type: text/markdown
+
+# instagram-data-mcp
+
+An MCP server for public Instagram data. It gives Claude, Cursor and any other MCP client
+27 read-only tools: profiles, posts, reels, stories, highlights, comments, likers,
+followers, hashtags, places, audio and search.
+
+It wraps the [Instagram Data API](https://fastsocial.co/instagram-api). Nothing logs in to
+Instagram, and nothing can post, follow or like. Public data only.
+
+## Get a key
+
+Sign up at https://fastsocial.co/instagram-api. There is a free plan.
+
+## Install
+
+Claude Code:
+
+```bash
+claude mcp add instagram-data --env IG_DATA_API_KEY=your_key -- uvx instagram-data-mcp
+```
+
+Claude Desktop, Cursor and other clients (`mcpServers` in the client's config file):
+
+```json
+{
+  "mcpServers": {
+    "instagram-data": {
+      "command": "uvx",
+      "args": ["instagram-data-mcp"],
+      "env": { "IG_DATA_API_KEY": "your_key" }
+    }
+  }
+}
+```
+
+No `uvx`? `pip install instagram-data-mcp` and use `"command": "instagram-data-mcp"` instead.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `instagram_profile` | Get an Instagram profile |
+| `instagram_user_id` | Instagram username to user id |
+| `instagram_username` | Instagram user id to username |
+| `instagram_check` | Check if an Instagram handle exists and is public |
+| `instagram_posts` | Get recent Instagram posts |
+| `instagram_reels` | Get an account's Instagram reels |
+| `instagram_tagged` | Get posts an account is tagged in |
+| `instagram_post` | Get one Instagram post or reel |
+| `instagram_media` | Download URLs for a post, reel or carousel |
+| `instagram_comments` | Get comments on an Instagram post |
+| `instagram_comment_replies` | Get replies to an Instagram comment |
+| `instagram_likers` | Get accounts that liked an Instagram post |
+| `instagram_insights` | Instagram engagement rate calculator |
+| `instagram_followers` | Get an account's followers |
+| `instagram_following` | Get accounts an account follows |
+| `instagram_similar` | Find similar Instagram accounts |
+| `instagram_stories` | View Instagram stories anonymously |
+| `instagram_highlights` | Get Instagram story highlights |
+| `instagram_highlight` | Get the items in one highlight |
+| `instagram_search` | Search Instagram accounts, hashtags and places |
+| `instagram_hashtag` | Get posts for an Instagram hashtag |
+| `instagram_place` | Get an Instagram location |
+| `instagram_place_posts` | Get posts tagged at an Instagram location |
+| `instagram_audio` | Get an Instagram audio track and the reels using it |
+| `instagram_audio_search` | Search Instagram music and sounds |
+| `instagram_reels_search` | Search Instagram reels by keyword |
+| `instagram_usage` | Your usage this month |
+
+Each call costs API credits (stories and highlights cost 3, most others 1). Every response
+includes `meta.credits_remaining`. Full reference: https://fastsocial.co/instagram-api/docs
+
+## Things to ask it
+
+- "Compare the engagement rate of @nasa and @spacex."
+- "Download every slide of this carousel: https://www.instagram.com/p/..."
+- "Show me @natgeo's current stories and summarise them."
+- "Find 10 accounts similar to @humansofny."
+
+## Settings
+
+| Env var | Default | |
+|---|---|---|
+| `IG_DATA_API_KEY` | none | Required |
+| `IG_DATA_API_BASE` | `https://data.fastsocial.co` | |
+| `IG_DATA_API_TIMEOUT` | `60` | Seconds |
+
+## License
+
+MIT

instagram_data_mcp-0.1.0/README.md

@@ -0,0 +1,90 @@
+# instagram-data-mcp
+
+An MCP server for public Instagram data. It gives Claude, Cursor and any other MCP client
+27 read-only tools: profiles, posts, reels, stories, highlights, comments, likers,
+followers, hashtags, places, audio and search.
+
+It wraps the [Instagram Data API](https://fastsocial.co/instagram-api). Nothing logs in to
+Instagram, and nothing can post, follow or like. Public data only.
+
+## Get a key
+
+Sign up at https://fastsocial.co/instagram-api. There is a free plan.
+
+## Install
+
+Claude Code:
+
+```bash
+claude mcp add instagram-data --env IG_DATA_API_KEY=your_key -- uvx instagram-data-mcp
+```
+
+Claude Desktop, Cursor and other clients (`mcpServers` in the client's config file):
+
+```json
+{
+  "mcpServers": {
+    "instagram-data": {
+      "command": "uvx",
+      "args": ["instagram-data-mcp"],
+      "env": { "IG_DATA_API_KEY": "your_key" }
+    }
+  }
+}
+```
+
+No `uvx`? `pip install instagram-data-mcp` and use `"command": "instagram-data-mcp"` instead.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `instagram_profile` | Get an Instagram profile |
+| `instagram_user_id` | Instagram username to user id |
+| `instagram_username` | Instagram user id to username |
+| `instagram_check` | Check if an Instagram handle exists and is public |
+| `instagram_posts` | Get recent Instagram posts |
+| `instagram_reels` | Get an account's Instagram reels |
+| `instagram_tagged` | Get posts an account is tagged in |
+| `instagram_post` | Get one Instagram post or reel |
+| `instagram_media` | Download URLs for a post, reel or carousel |
+| `instagram_comments` | Get comments on an Instagram post |
+| `instagram_comment_replies` | Get replies to an Instagram comment |
+| `instagram_likers` | Get accounts that liked an Instagram post |
+| `instagram_insights` | Instagram engagement rate calculator |
+| `instagram_followers` | Get an account's followers |
+| `instagram_following` | Get accounts an account follows |
+| `instagram_similar` | Find similar Instagram accounts |
+| `instagram_stories` | View Instagram stories anonymously |
+| `instagram_highlights` | Get Instagram story highlights |
+| `instagram_highlight` | Get the items in one highlight |
+| `instagram_search` | Search Instagram accounts, hashtags and places |
+| `instagram_hashtag` | Get posts for an Instagram hashtag |
+| `instagram_place` | Get an Instagram location |
+| `instagram_place_posts` | Get posts tagged at an Instagram location |
+| `instagram_audio` | Get an Instagram audio track and the reels using it |
+| `instagram_audio_search` | Search Instagram music and sounds |
+| `instagram_reels_search` | Search Instagram reels by keyword |
+| `instagram_usage` | Your usage this month |
+
+Each call costs API credits (stories and highlights cost 3, most others 1). Every response
+includes `meta.credits_remaining`. Full reference: https://fastsocial.co/instagram-api/docs
+
+## Things to ask it
+
+- "Compare the engagement rate of @nasa and @spacex."
+- "Download every slide of this carousel: https://www.instagram.com/p/..."
+- "Show me @natgeo's current stories and summarise them."
+- "Find 10 accounts similar to @humansofny."
+
+## Settings
+
+| Env var | Default | |
+|---|---|---|
+| `IG_DATA_API_KEY` | none | Required |
+| `IG_DATA_API_BASE` | `https://data.fastsocial.co` | |
+| `IG_DATA_API_TIMEOUT` | `60` | Seconds |
+
+## License
+
+MIT

instagram_data_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "instagram-data-mcp"
+version = "0.1.0"
+description = "MCP server for public Instagram data: profiles, posts, reels, stories, highlights, comments, hashtags and more."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = ["mcp>=2.2", "httpx>=0.27", "anyio>=4"]
+keywords = ["mcp", "instagram", "model-context-protocol", "instagram-api", "scraper", "claude", "ai-agents"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Topic :: Internet :: WWW/HTTP",
+  "Intended Audience :: Developers",
+]
+
+[project.urls]
+Homepage = "https://fastsocial.co/instagram-api"
+Documentation = "https://fastsocial.co/instagram-api/docs"
+
+[project.scripts]
+instagram-data-mcp = "instagram_data_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/instagram_data_mcp"]

instagram_data_mcp-0.1.0/src/instagram_data_mcp/__init__.py

@@ -0,0 +1,2 @@
+"""MCP server for the Instagram Data API."""
+__version__ = "0.1.0"

instagram_data_mcp-0.1.0/src/instagram_data_mcp/__main__.py

@@ -0,0 +1,3 @@
+from .server import main
+
+main()