Skip to main content

MCP 集成

MCP 工具：将 AI 代理连接到社交媒体数据

使用模型上下文协议 (MCP) 让 Claude、Cursor、VS Code 和任何 MCP 兼容的 AI 代理直接访问 16 个平台的 990+ 社交数据工具。使用实时数据构建 AI 驱动的社交媒体工作流。

免费获取 API 密钥查看定价初次使用 TikHub？从这里开始 →

990+

MCP 工具

覆盖所有平台

16

平台 MCP

专用服务器

3

传输方式

Stdio · SSE · 流式 HTTP

3 行配置

3 行配置

粘贴配置即可使用

选择传输方式

TikHub MCP 支持三种传输模式，请选择适合您客户端的方式。

Stdio

桌面 MCP 客户端的默认选项。通过 npx mcp-remote 将 HTTP 桥接到 stdio。需要 Node.js。

适用场景
Claude Desktop、VS Code、Claude Code
认证方式
npx mcp-remote 桥接 HTTP → stdio
跳转到设置

SSE

服务器推送事件 (SSE) 传输，适用于需要流式连接的旧版客户端。

适用场景
需要 SSE 的旧版客户端
认证方式
请求头中的 Bearer Token
跳转到设置

流式 HTTP

直接 HTTP 调用，原生支持 MCP 的客户端最高效的方式。

适用场景
Cherry Studio、Cursor、Cline、curl、自定义客户端
认证方式
请求头中的 Bearer Token
跳转到设置

Stdio

1. Stdio 传输

Stdio 是桌面 MCP 客户端的默认选项。由于 TikHub MCP 服务器是远程的，我们使用 npx mcp-remote 将 HTTP 桥接到 stdio。需要安装 Node.js。

请将 YOUR_API_KEY 替换为您在 tikhub.io 获取的 API 密钥。

Stdio 配置生成器

选择客户端和需要的平台，我们会生成可直接粘贴的配置。

选择您的客户端

配置文件位置

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

选择平台 已选择 1 个

claude_desktop_config.json
1{
2  "mcpServers": {
3    "tikhub-tiktok": {
4      "command": "npx",
5      "args": ["mcp-remote", "https://mcp.tikhub.io/tiktok/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
6    }
7  }
8}

保存后请重启客户端。仅添加您实际使用的平台。

SSE

2. SSE 传输

适用于通过 SSE 连接的客户端。使用相同的托管服务器，路径为 /sse。

托管端点

URLhttps://mcp.tikhub.io/{platform}/sse
HeaderAuthorization: Bearer YOUR_API_KEY

自托管 SSE

在本地以 SSE 服务器的形式运行单个平台。客户端连接 http://localhost:8001/sse。

Terminal
1tikhub-mcp --platform tiktok --transport sse --port 8001

流式 HTTP

3. 流式 HTTP 传输

适用于原生支持流式 HTTP 的客户端 (无需 stdio 桥接)。最直接、最高效的方式。

URL 格式https://mcp.tikhub.io/{platform}/mcp
请求头Authorization: Bearer YOUR_API_KEY
  1. 1打开 设置 → MCP 服务器
  2. 2点击 添加服务器，选择 Streamable HTTP
  3. 3填写名称、URL 和 Authorization 请求头
  4. 4对每个需要的平台重复以上步骤
URLhttps://mcp.tikhub.io/{platform}/mcp
HeaderAuthorization: Bearer YOUR_API_KEY

LangChain

4. LangChain / LangGraph 集成

通过 langchain-mcp-adapters 在 LangChain 代理中使用 TikHub MCP 工具。

安装

Terminal
1pip install langchain-mcp-adapters langgraph langchain-openai

单个平台 (流式 HTTP)

single_platform.py
1import asyncio
2from langchain_mcp_adapters.client import MultiServerMCPClient
3from langgraph.prebuilt import create_react_agent
4from langchain_openai import ChatOpenAI
5
6async def main():
7    async with MultiServerMCPClient(
8        {
9            "tikhub-tiktok": {
10                "transport": "streamable_http",
11                "url": "https://mcp.tikhub.io/tiktok/mcp",
12                "headers": {"Authorization": "Bearer YOUR_API_KEY"},
13            },
14        }
15    ) as client:
16        tools = client.get_tools()
17        agent = create_react_agent(ChatOpenAI(model="gpt-4o"), tools)
18        response = await agent.ainvoke(
19            {"messages": [{"role": "user", "content": "Get TikTok video details for ID 7350810998023949599"}]}
20        )
21        print(response)
22
23asyncio.run(main())

多个平台

multiple_platforms.py
1async with MultiServerMCPClient(
2    {
3        "tikhub-tiktok": {
4            "transport": "streamable_http",
5            "url": "https://mcp.tikhub.io/tiktok/mcp",
6            "headers": {"Authorization": "Bearer YOUR_API_KEY"},
7        },
8        "tikhub-instagram": {
9            "transport": "streamable_http",
10            "url": "https://mcp.tikhub.io/instagram/mcp",
11            "headers": {"Authorization": "Bearer YOUR_API_KEY"},
12        },
13        "tikhub-youtube": {
14            "transport": "streamable_http",
15            "url": "https://mcp.tikhub.io/youtube/mcp",
16            "headers": {"Authorization": "Bearer YOUR_API_KEY"},
17        },
18    }
19) as client:
20    tools = client.get_tools()
21    agent = create_react_agent(ChatOpenAI(model="gpt-4o"), tools)

Stdio 变体 (使用 mcp-remote)

stdio_variant.py
1from langchain_mcp_adapters.client import MultiServerMCPClient
2
3async with MultiServerMCPClient(
4    {
5        "tikhub-tiktok": {
6            "transport": "stdio",
7            "command": "npx",
8            "args": [
9                "mcp-remote",
10                "https://mcp.tikhub.io/tiktok/mcp",
11                "--header",
12                "Authorization: Bearer YOUR_API_KEY",
13            ],
14        },
15    }
16) as client:
17    tools = client.get_tools()

服务器端点

托管服务器上的两个无需认证的元数据端点。

健康检查

GET /health
1curl https://mcp.tikhub.io/health

列出所有平台

GET /platforms
1curl https://mcp.tikhub.io/platforms

JSON-RPC 2.0 入门

所有 HTTP / SSE 请求遵循 JSON-RPC 2.0 规范。流程：initialize → 保存 session id → tools/list → tools/call。

1. 初始化会话 (必须先调用)

返回 Mcp-Session-Id，后续每个请求都需要携带。

initialize
1curl -X POST https://mcp.tikhub.io/tiktok/mcp \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -H "Accept: application/json, text/event-stream" \
5  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0"}}}'

2. 列出工具

返回该平台开放的工具目录 — 名称、描述和 JSON Schema。

tools/list
1curl -X POST https://mcp.tikhub.io/tiktok/mcp \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -H "Accept: application/json, text/event-stream" \
5  -H "Mcp-Session-Id: SESSION_ID_FROM_INITIALIZE" \
6  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

3. 调用工具

传入工具名以及与其 Schema 匹配的参数。

tools/call
1curl -X POST https://mcp.tikhub.io/tiktok/mcp \
2  -H "Authorization: Bearer YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -H "Accept: application/json, text/event-stream" \
5  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"tiktok_web_fetch_post_detail","arguments":{"itemId":"7350810998023949599"}}}'

可用平台

请将任意 URL 中的 {platform} 替换为下表中的 Slug。

  • TikTok
    tiktok
    204工具

    Videos, users, search, ads, shop, analytics, creator tools

  • Douyin
    douyin
    247工具

    Videos, users, search, billboard, creator, Xingtu

  • Instagram
    instagram
    82工具

    Posts, reels, stories, users, comments, hashtags

  • Xiaohongshu
    xiaohongshu
    71工具

    Notes, users, search, comments

  • Weibo
    weibo
    64工具

    Posts, users, comments, search, trending

  • Others
    others
    64工具

    Lemon8, PiPiXia, Xigua, Toutiao, Sora2

  • Bilibili
    bilibili
    41工具

    Videos, users, comments, danmaku, search

  • YouTube
    youtube
    37工具

    Videos, channels, comments, search, playlists

  • Kuaishou
    kuaishou
    33工具

    Videos, users, comments, search

  • Zhihu
    zhihu
    32工具

    Questions, answers, users, topics, search

  • LinkedIn
    linkedin
    25工具

    Profiles, posts, companies, search

  • Reddit
    reddit
    24工具

    Posts, comments, subreddits, users, search

  • TikHub Utilities
    tikhub
    23工具

    Account info, downloader, health check, hybrid parsing, temp mail

  • WeChat
    wechat
    19工具

    Articles, accounts, channels, search

  • Twitter
    twitter
    13工具

    Tweets, users, search, timelines

  • @Threads
    threads
    11工具

    Posts, users, replies, search