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