Skip to main content

Intégration MCP

Outils MCP : connectez vos agents IA aux données des réseaux sociaux

Utilisez le Model Context Protocol (MCP) pour donner à Claude, Cursor, VS Code et à tout agent IA compatible MCP un accès direct à 990+ outils de données sociales sur 16 plateformes. Construisez des workflows sociaux pilotés par l'IA, avec des données en temps réel.

990+

Outils MCP

Toutes plateformes confondues

16

MCP par plateforme

Serveurs dédiés

3

Transports

Stdio · SSE · Streamable HTTP

3 lignes

3 lignes

Collez la config, c'est parti

Stdio

1. Transport Stdio

Stdio est le mode par défaut des clients MCP de bureau. Le serveur MCP TikHub étant distant, on passe par npx mcp-remote pour faire le pont entre HTTP et stdio. Node.js doit être installé.

Remplacez YOUR_API_KEY par votre clé TikHub, disponible sur tikhub.io.

Configurateur Stdio

Choisissez votre client et les plateformes qu'il vous faut — nous générons la configuration exacte à coller.

Choisissez votre client

Emplacement du fichier de configuration

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

Windows : %APPDATA%\Claude\claude_desktop_config.json

Sélectionnez les plateformes 1 sélectionnée(s)

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}

Redémarrez votre client après enregistrement. N'ajoutez que les plateformes que vous utilisez.

SSE

2. Transport SSE

Pour les clients qui se connectent en Server-Sent Events. Même serveur hébergé, avec le chemin /sse.

Endpoint hébergé

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

SSE auto-hébergé

Faites tourner une seule plateforme en local comme serveur SSE. Les clients se connectent à http://localhost:8001/sse.

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

Streamable HTTP

3. Transport Streamable HTTP

Pour les clients qui prennent en charge nativement le streamable HTTP (sans pont stdio). La méthode la plus directe et la plus efficace.

Format de l'URLhttps://mcp.tikhub.io/{platform}/mcp
En-têteAuthorization: Bearer YOUR_API_KEY
  1. 1Ouvrez Settings → MCP Servers
  2. 2Cliquez sur Add Server et choisissez Streamable HTTP
  3. 3Renseignez le nom, l'URL et l'en-tête Authorization
  4. 4Répétez l'opération pour chaque plateforme voulue
URLhttps://mcp.tikhub.io/{platform}/mcp
HeaderAuthorization: Bearer YOUR_API_KEY

LangChain

4. Intégration LangChain / LangGraph

Utilisez les outils TikHub MCP dans vos agents LangChain via langchain-mcp-adapters.

Installation

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

Une seule plateforme (Streamable 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())

Plusieurs plateformes

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)

Variante Stdio (avec 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()

Endpoints du serveur

Deux méta-endpoints sans authentification sur le serveur hébergé.

Vérification d'état

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

Lister toutes les plateformes

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

JSON-RPC 2.0 en bref

Toutes les requêtes HTTP / SSE suivent la spécification JSON-RPC 2.0. Le déroulé : initialize → mémoriser l'identifiant de session → tools/list → tools/call.

1. Initialiser la session (indispensable en premier)

Renvoie un Mcp-Session-Id à inclure dans tous les appels suivants.

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. Lister les outils

Renvoie le catalogue des outils exposés par la plateforme : noms, descriptions et schémas JSON.

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. Appeler un outil

Indiquez le nom de l'outil et les arguments conformes à son schéma.

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"}}}'

Plateformes disponibles

Remplacez {platform} dans n'importe quelle URL par le slug du tableau.

  • TikTok
    tiktok
    204outils

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

  • Douyin
    douyin
    247outils

    Videos, users, search, billboard, creator, Xingtu

  • Instagram
    instagram
    82outils

    Posts, reels, stories, users, comments, hashtags

  • Xiaohongshu
    xiaohongshu
    71outils

    Notes, users, search, comments

  • Weibo
    weibo
    64outils

    Posts, users, comments, search, trending

  • Others
    others
    64outils

    Lemon8, PiPiXia, Xigua, Toutiao, Sora2

  • Bilibili
    bilibili
    41outils

    Videos, users, comments, danmaku, search

  • YouTube
    youtube
    37outils

    Videos, channels, comments, search, playlists

  • Kuaishou
    kuaishou
    33outils

    Videos, users, comments, search

  • Zhihu
    zhihu
    32outils

    Questions, answers, users, topics, search

  • LinkedIn
    linkedin
    25outils

    Profiles, posts, companies, search

  • Reddit
    reddit
    24outils

    Posts, comments, subreddits, users, search

  • TikHub Utilities
    tikhub
    23outils

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

  • WeChat
    wechat
    19outils

    Articles, accounts, channels, search

  • Twitter
    twitter
    13outils

    Tweets, users, search, timelines

  • @Threads
    threads
    11outils

    Posts, users, replies, search