Skip to main content

Integración MCP

Herramientas MCP: conecta agentes de IA a los datos de redes sociales

Usa el Model Context Protocol (MCP) para dar a Claude, Cursor, VS Code y a cualquier agente de IA compatible con MCP acceso directo a 990+ herramientas de datos sociales en 16 plataformas. Crea flujos de trabajo de redes sociales con IA y datos en tiempo real.

Consigue tu clave API gratisVer precios¿Es tu primera vez en TikHub? Empieza aquí →

990+

Herramientas MCP

En todas las plataformas

16

MCP por plataforma

Servidores dedicados

3

Transportes

Stdio · SSE · Streamable HTTP

3 líneas

3 líneas

Pega la configuración y listo

Elige tu transporte

El MCP de TikHub admite tres modos de transporte. Elige el que encaje con tu cliente.

Stdio

El modo por defecto en los clientes MCP de escritorio. Usa npx mcp-remote para puentear HTTP a stdio. Requiere Node.js.

Ideal para
Claude Desktop, VS Code, Claude Code
Método de autenticación
npx mcp-remote puentea HTTP → stdio
Ir a la configuración

SSE

Transporte Server-Sent Events. Para clientes antiguos que necesitan una conexión de streaming.

Ideal para
Clientes antiguos que necesitan Server-Sent Events
Método de autenticación
Token Bearer en la cabecera
Ir a la configuración

Streamable HTTP

HTTP directo: lo más eficiente para clientes con soporte nativo.

Ideal para
Cherry Studio, Cursor, Cline, curl, clientes propios
Método de autenticación
Token Bearer en la cabecera
Ir a la configuración

Stdio

1. Transporte Stdio

Stdio es el modo por defecto en los clientes MCP de escritorio. Como el servidor MCP de TikHub es remoto, usamos npx mcp-remote para puentear HTTP a stdio. Requiere tener Node.js instalado.

Sustituye YOUR_API_KEY por tu clave de TikHub, que encuentras en tikhub.io.

Configurador de Stdio

Elige un cliente y las plataformas que necesitas: generamos la configuración exacta que debes pegar.

Elige tu cliente

Ubicación del archivo de configuración

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

Selecciona plataformas 1 seleccionadas

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}

Reinicia tu cliente después de guardar. Añade solo las plataformas que uses.

SSE

2. Transporte SSE

Para clientes que se conectan mediante Server-Sent Events. El mismo servidor alojado, con la ruta /sse.

Endpoint alojado

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

SSE autoalojado

Ejecuta una sola plataforma en local como servidor SSE. Los clientes se conectan a http://localhost:8001/sse.

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

Streamable HTTP

3. Transporte Streamable HTTP

Para clientes que admiten HTTP en streaming de forma nativa, sin puente stdio. Es el método más directo y eficiente.

Patrón de URLhttps://mcp.tikhub.io/{platform}/mcp
CabeceraAuthorization: Bearer YOUR_API_KEY
  1. 1Abre Settings → MCP Servers
  2. 2Haz clic en Add Server y selecciona Streamable HTTP
  3. 3Indica el nombre, la URL y la cabecera Authorization
  4. 4Repítelo con cada plataforma que necesites
URLhttps://mcp.tikhub.io/{platform}/mcp
HeaderAuthorization: Bearer YOUR_API_KEY

LangChain

4. Integración con LangChain / LangGraph

Usa las herramientas MCP de TikHub en tus agentes de LangChain mediante langchain-mcp-adapters.

Instalación

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

Una sola plataforma (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())

Varias plataformas

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 (con 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 del servidor

Dos metaendpoints sin autenticación en el servidor alojado.

Comprobación de estado

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

Listar todas las plataformas

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

Introducción a JSON-RPC 2.0

Todas las peticiones HTTP / SSE siguen la especificación JSON-RPC 2.0. El flujo es: initialize → guardar el id de sesión → tools/list → tools/call.

1. Iniciar la sesión (obligatorio al principio)

Devuelve un Mcp-Session-Id que debes incluir en todas las llamadas posteriores.

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. Listar las herramientas

Devuelve el catálogo de herramientas que expone la plataforma: nombres, descripciones y esquemas 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. Llamar a una herramienta

Pasa el nombre de la herramienta y los argumentos que correspondan a su esquema.

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

Plataformas disponibles

Sustituye {platform} en cualquier URL por el slug de la tabla.

  • TikTok
    tiktok
    204herramientas

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

  • Douyin
    douyin
    247herramientas

    Videos, users, search, billboard, creator, Xingtu

  • Instagram
    instagram
    82herramientas

    Posts, reels, stories, users, comments, hashtags

  • Xiaohongshu
    xiaohongshu
    71herramientas

    Notes, users, search, comments

  • Weibo
    weibo
    64herramientas

    Posts, users, comments, search, trending

  • Others
    others
    64herramientas

    Lemon8, PiPiXia, Xigua, Toutiao, Sora2

  • Bilibili
    bilibili
    41herramientas

    Videos, users, comments, danmaku, search

  • YouTube
    youtube
    37herramientas

    Videos, channels, comments, search, playlists

  • Kuaishou
    kuaishou
    33herramientas

    Videos, users, comments, search

  • Zhihu
    zhihu
    32herramientas

    Questions, answers, users, topics, search

  • LinkedIn
    linkedin
    25herramientas

    Profiles, posts, companies, search

  • Reddit
    reddit
    24herramientas

    Posts, comments, subreddits, users, search

  • TikHub Utilities
    tikhub
    23herramientas

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

  • WeChat
    wechat
    19herramientas

    Articles, accounts, channels, search

  • Twitter
    twitter
    13herramientas

    Tweets, users, search, timelines

  • @Threads
    threads
    11herramientas

    Posts, users, replies, search