InsightSocial

app.insightsocialv0.1.0更新于 Oct 3, 2026

Live public data from Instagram, TikTok, LinkedIn, YouTube, X and 4 more networks, via one key.

已验证STDIO仅桌面Web Search & Scraping Data & Analytics Communication & Collaboration

概览

AI 生成的概览

让助手搜索并调用 239 个 InsightSocial 付费接口，获取九大社交网络的实时公开数据。

功能: 把 InsightSocial API 封装为 MCP 工具：search_endpoints 和 describe_endpoint 免费查找并说明接口，call_endpoint 获取数据并保存完整响应、同时返回带 result_id 的精简视图，read_result 用 jq 在本地重新切分已保存结果，get_credits 查询余额与用量。覆盖个人资料、公开邮箱、帖子、短视频、评论、粉丝、点赞者、话题标签、搜索、公司主页、职位、广告和文字稿，各平台使用统一字段结构。
适用场景: 当助手需要 Instagram、TikTok、LinkedIn、Facebook、YouTube、X、Reddit、Threads 或 Pinterest 的实时公开数据时适用，例如查询资料、互动指标、话题标签或关键词搜索、获取文字稿。也适合希望先在本地查看大响应、而不是把全部内容放进上下文的智能体流程。
运行要求: 通过 npx 以 stdio 方式在本地运行，需要 Node.js。调用数据接口需要 InsightSocial API 密钥，可通过 INSIGHTSOCIAL_API_KEY 环境变量、--api-key 参数或 login 写入的配置文件提供；搜索和描述接口无需密钥。需要访问 InsightSocial API 的网络连接，密钥会向服务端校验。

安装前请注意

接口按端点计价、按调用收费，使用会产生费用，且每一页结果都是一次单独计费的调用。服务器会处理密钥 INSIGHTSOCIAL_API_KEY 并将其保存在配置文件中。它从社交平台获取第三方公开数据，保存的结果会写入本地目录。

安装

在 SourceWeft 中

打开控制台中的 InsightSocial，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

README

insightsocial

The official CLI and MCP server for the InsightSocial API: live public data from Instagram, TikTok, LinkedIn, Facebook, YouTube, X, Reddit, Threads and Pinterest through one key.

239 endpoints: profiles, public emails, posts, reels, comments, followers, likers, hashtags, search, company pages, jobs, ads and transcripts.
One schema across platforms: a TikTok video and an Instagram post come back with the same fields (post.url, post.engagement.likes, computed.engagement_rate).
Priced per endpoint, charged per call. Empty results, failed calls and idempotent replays are free.
Built for agents. Every result is saved in full, and you re-slice it locally with jq for free, so a 50 KB page never ends up in your context.

Quick start

npx -y insightsocial init              # save your key, install the agent skill, show MCP setupnpx -y insightsocial search instagram followersnpx -y insightsocial run /v1/instagram/profile -p handle=natgeonpx -y insightsocial view --last --jq '.data.author | {username, followers}'

npx -y insightsocial init              # save your key, install the agent skill, show MCP setupnpx -y insightsocial search instagram followersnpx -y insightsocial run /v1/instagram/profile -p handle=natgeonpx -y insightsocial view --last --jq '.data.author | {username, followers}'

Get a key at https://www.insightsocial.app/portal/api/keys. New accounts include free calls.

Use it from an AI agent

Claude Code plugin

This installs the skill and the MCP server together, from insightsocial/skills. Run npx -y insightsocial login once so the server can find your key.

MCP server (any client)

json

{  "mcpServers": {    "insightsocial": { "command": "npx", "args": ["-y", "insightsocial", "mcp"] }  }}

{  "mcpServers": {    "insightsocial": { "command": "npx", "args": ["-y", "insightsocial", "mcp"] }  }}

The server reads the key saved by insightsocial login, so the config holds no secret. You can also pass INSIGHTSOCIAL_API_KEY in its env. Without a key, search and describe still work.

Tool	What it does
`search_endpoints`	Find endpoints by keywords and platform. Free.
`describe_endpoint`	Inputs, allowed values, an example and the price for one endpoint. Free.
`call_endpoint`	Fetch data. Saves the full response and returns a `result_id` with a trimmed view (10 items by default) and a ready `next_call` for the next page.
`read_result`	Re-slice a saved result with jq, fields, max_items or an outline with sizes. Free.
`get_credits`	Balance, plan and usage. Free.

insightsocial init --yes writes the MCP entry into Claude Code, Codex and Cursor for you.

Commands

Command
`init [--yes] [--no-skills]`	Save a key, install the skill for detected agents, print or write the MCP config.
`login [--api-key k]` / `logout`	Save (after checking it) or remove your key.
`search <words> [--platform p]`	Find endpoints. Free.
`list [--platform p]`	Every endpoint with its price. Free.
`describe <path>`	Inputs, example and price. Free.
`run <path> -p name=value …`	Call an endpoint. Saves to `./.insightsocial/`. Options: `--input <json>`, `-i file`, `--idempotency-key`, `--fresh`, `--max-credits N`, `-o file`, `--json`, and the shaping flags below.
`view [file] [--last [endpoint]]`	Re-shape a saved result. No network, no charge.
`credits`	Balance and usage. Free.
`mcp`	Start the MCP server over stdio.

Shaping flags (run and view) trim only what is printed; the saved file is always complete:

--jq <expr>: real jq (bundled, nothing to install) over the saved response. Paths start at .data.
--fields a,b.c: keep these keys on each item. Dotted paths descend.
--max-items N: show at most N items.
--summary: the structure with byte sizes, so you can see what is large before pulling it.

Paging: when there is another page, run prints the exact next command. Each page is a separate charged call.

Configuration


Key	`--api-key`, then `INSIGHTSOCIAL_API_KEY`, then `~/.insightsocial/config.json` (mode 600)
`INSIGHTSOCIAL_BASE_URL`	Defaults to `https://api.insightsocial.app`
`INSIGHTSOCIAL_HOME`	Defaults to `~/.insightsocial` (config, catalogue cache, MCP results)

Develop

License

MIT

来源：README.md，提交 59881fe

工具

工具元数据尚未被收录。

版本历史

v0.1.0最新Oct 3, 2026