InsightSocial

insightsocial

InsightSocial API 的官方 CLI 和 MCP 服务：通过一个密钥获取来自 22 个平台 的实时公开数据：TikTok、LinkedIn、YouTube、X、Reddit、Pinterest、Bluesky、Truth Social、Snapchat、Telegram、Twitch、Kick、Rumble、Kwai、Douyin、Xiaohongshu（RedNote）、Quora、TikTok Shop、Weibo、Zhihu、Substack 和 Nextdoor。

• 230 多个端点：个人资料、公开邮箱、帖子、视频、评论、粉丝、点赞者、话题标签、搜索、公司页面、职位、广告、转录文本、商店商品和本地商家列表。
• 跨平台统一的 Schema：TikTok 视频和 YouTube 视频会返回相同字段（post.url、post.kind、post.engagement.likes、post.language），而 unavailable 会列出响应中无法填充的字段。CLI 和 MCP 服务每次调用都会请求 schema 2。
• 按端点定价，按调用收费。 空结果、失败调用和幂等重放均免费。
• 专为 Agent 打造。 每个结果都会完整保存，你可以在本地用 jq 免费重新切片，因此 50 KB 的页面不会全部进入上下文。

快速开始

npx -y insightsocial init              # sign in through your browser, install the agent skill, show MCP setup
npx -y insightsocial search tiktok followers
npx -y insightsocial run /v1/tiktok/profile -p handle=natgeo
npx -y insightsocial view --last --jq '.data.author | {username, followers}'

init 和 login 会通过浏览器为你登录：它们会打开登录页面并打印一段短代码；你在页面中输入代码并点击 Allow 后，系统会保存一个以这台机器命名的密钥。随后 CLI 会显示登录的账户。若要使用已有密钥，请传入 --api-key。新账户包含免费调用额度。

在 AI Agent 中使用

Claude Code 插件

/plugin marketplace add insightsocial/skills
/plugin install insightsocial@insightsocial

此操作会从 insightsocial/skills 同时安装技能和 MCP 服务。运行一次 npx -y insightsocial login，让服务找到你的密钥。

MCP 服务（任何客户端）

claude mcp add insightsocial --scope user -- npx -y insightsocial mcp

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

服务会读取通过 insightsocial login 保存的密钥，因此配置中不包含机密。你也可以在其 env 中传入 INSIGHTSOCIAL_API_KEY。即使没有密钥，搜索和描述功能仍可使用。

无需安装：相同的工具托管在 https://api.insightsocial.app/mcp。支持该功能的 Claude、ChatGPT 和其他客户端可通过 OAuth 登录；其他客户端则通过 Authorization: Bearer 发送密钥。请参阅 MCP 文档。

工具	功能
search_endpoints	按关键字和平台查找端点。免费。
describe_endpoint	查看一个端点的输入、允许值、示例和价格。免费。
call_endpoint	获取数据。完整响应会被保存，并返回一个 result_id，其中包含精简视图（默认 10 项）和可直接用于获取下一页的 next_call。
read_result	使用 jq、字段、max_items 或带大小信息的大纲重新切片已保存的结果。免费。
get_credits	查看余额、套餐和用量。免费。

insightsocial init --yes 会自动将 MCP 条目写入 Claude Code、Codex 和 Cursor。

命令

命令
init [--yes] [--no-skills]	保存密钥，为检测到的 Agent 安装技能，并打印或写入 MCP 配置。
login [--api-key k] [--no-browser] / logout	通过浏览器登录（或保存你提供的密钥）/ 移除密钥。
search <words> [--platform p]	查找端点。免费。
list [--platform p]	列出所有端点及其价格。免费。
describe <path>	输入、示例和价格。免费。
run <path> -p name=value …	调用端点。保存到 ./.insightsocial/。选项：--input <json>、-i file、--idempotency-key、--fresh、--max-credits N、-o file、--json，以及以下整形标志。
view [file] [--last [endpoint]]	重新整形已保存的结果。不联网，不收费。
credits	余额和用量。免费。
mcp	通过 stdio 启动 MCP 服务。

整形标志（run 和 view）只会裁剪打印内容；保存的文件始终完整：

• --jq <expr>：对已保存的响应运行真正的 jq（已捆绑，无需安装）。路径从 .data 开始。
• --fields a,b.c：保留每个项目中的这些键。点分路径表示向下级访问。
• --max-items N：最多显示 N 个项目。
• --summary：显示带字节大小的结构，以便在提取前查看哪些内容较大。

分页：如果还有下一页，run 会打印确切的 next 命令。每一页都是一次单独计费的调用。

先为调用报价：在任意端点上使用 -p dry_run=1（或 true），即可返回报价且不收费。如果响应无法填充平台通常提供的某个字段，run 会将其打印在 missing 下；其中的 null 表示未知，而非零。

配置

密钥	--api-key，然后是 INSIGHTSOCIAL_API_KEY，再然后是 ~/.insightsocial/config.json（权限模式为 600）
INSIGHTSOCIAL_BASE_URL	默认为 https://api.insightsocial.app
INSIGHTSOCIAL_HOME	默认为 ~/.insightsocial（配置、目录缓存、MCP 结果）

开发

npm install
npm run check      # build + unit tests, no network and no key needed

许可证

MIT