Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

TikTok Shop

de Buer2333versión 0.3.0i★ 10iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.Buer2333/tiktok-shop-mcp

Cómo instalar

What it does

Read-only TikTok Shop Partner API: orders, finance, products and analytics across shops.

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Tiendas en línea y pagos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad12/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso24/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala TikTok Shop. Sigue https://mcp.popnx.com/i/buer2333-tiktok-shop-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server TikTok Shop para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "tiktok-shop": { "command": "uvx", "args": [ "tiktok-shop-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de TikTok Shop aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "tiktok-shop": {
          "command": "uvx",
          "args": [
            "tiktok-shop-mcp"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa TikTok Shop y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando TikTok Shop o muestra una herramienta de TikTok Shop en la respuesta, ya está conectado

2 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TIKTOK_SHOP_CONFIG Ruta a shops.json (por defecto /.config/tiktok-mcp/shops.json)
    Ver original en inglésPath to shops.json (default ~/.config/tiktok-mcp/shops.json)
  • TIKTOK_SHOP_BESTSELLERS_SHOP Tienda usada por las herramientas más vendidas cuando se omite seller_name
    Ver original en inglésShop used by the bestselling tools when seller_name is omitted

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar TikTok Shop

TikTok Shop se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar TikTok Shop

  • Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Python (uv) en tu computadora primero (una sola vez)
  • Instala Python (uv) en tu computadora primero (una sola vez)
  • Instala Python (uv) en tu computadora primero (una sola vez)

B · Otros en Tiendas en línea y pagos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server TikTok Shop para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user tiktok-shop -- uvx tiktok-shop-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de TikTok Shop aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user tiktok-shop -- uvx tiktok-shop-mcp
  4. Escribe /mcp en Claude Code

    Deberías ver TikTok Shop en la lista como conectado

  5. Pruébalo

    Usa TikTok Shop y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando TikTok Shop o muestra una herramienta de TikTok Shop en la respuesta, ya está conectado

2 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TIKTOK_SHOP_CONFIG Ruta a shops.json (por defecto /.config/tiktok-mcp/shops.json)
    Ver original en inglésPath to shops.json (default ~/.config/tiktok-mcp/shops.json)
  • TIKTOK_SHOP_BESTSELLERS_SHOP Tienda usada por las herramientas más vendidas cuando se omite seller_name
    Ver original en inglésShop used by the bestselling tools when seller_name is omitted

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server TikTok Shop para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "tiktok-shop": { "command": "uvx", "args": [ "tiktok-shop-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de TikTok Shop aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa TikTok Shop y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando TikTok Shop o muestra una herramienta de TikTok Shop en la respuesta, ya está conectado

2 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TIKTOK_SHOP_CONFIG Ruta a shops.json (por defecto /.config/tiktok-mcp/shops.json)
    Ver original en inglésPath to shops.json (default ~/.config/tiktok-mcp/shops.json)
  • TIKTOK_SHOP_BESTSELLERS_SHOP Tienda usada por las herramientas más vendidas cuando se omite seller_name
    Ver original en inglésShop used by the bestselling tools when seller_name is omitted

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server TikTok Shop para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "tiktok-shop": { "type": "stdio", "command": "uvx", "args": [ "tiktok-shop-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de TikTok Shop aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa TikTok Shop y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando TikTok Shop o muestra una herramienta de TikTok Shop en la respuesta, ya está conectado

2 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • TIKTOK_SHOP_CONFIG Ruta a shops.json (por defecto /.config/tiktok-mcp/shops.json)
    Ver original en inglésPath to shops.json (default ~/.config/tiktok-mcp/shops.json)
  • TIKTOK_SHOP_BESTSELLERS_SHOP Tienda usada por las herramientas más vendidas cuando se omite seller_name
    Ver original en inglésShop used by the bestselling tools when seller_name is omitted

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa TikTok Shop💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user tiktok-shop -- uvx tiktok-shop-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "tiktok-shop": {
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "tiktok-shop": {
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "tiktok-shop": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "tiktok-shop-mcp"
      ]
    }
  }
}

Valores que debes completar

  • TIKTOK_SHOP_CONFIG env
    Ruta a shops.json (por defecto /.config/tiktok-mcp/shops.json)
    Ver original en inglésPath to shops.json (default ~/.config/tiktok-mcp/shops.json)
  • TIKTOK_SHOP_BESTSELLERS_SHOP env
    Tienda usada por las herramientas más vendidas cuando se omite seller_name
    Ver original en inglésShop used by the bestselling tools when seller_name is omitted

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
83/sem
Conexión
Se ejecuta en tu computadora
Última versióni
0.3.0
Publicado en el registroi
19 oct 2026
Último cambio de códigoi
17 nov 2026
Creador
Buer2333
Paquetes
pypi: tiktok-shop-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub Buer2333, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: anteayer

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para tiktok-shop-mcp@0.3.0

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/buer2333-tiktok-shop-mcp.svg)](https://mcp.popnx.com/en/servers/buer2333-tiktok-shop-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Tiendas en línea y pagosi

  • Más estrellas que el 98% de los otros 2941 servidores de esta categoría
  • Publicado en el registro más recientemente que el 48% de los otros 2941 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 2941 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro TikTok Shop?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez anteayer, y la última versión (0.3.0) llegó al registro hace 31 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

de stripeMuy usado★ 2,1 milActualizado hace 13 meses

Se ejecuta en la nube✓ del servicio · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

de flightclawEn crecimiento★ 86Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

de trade-it-incInicial★ 62Actualizado hace 34 días

Se ejecuta en la nube✓ del servicio · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

de idealoInicial★ 28Actualizado hace 6 meses

Se ejecuta en la nube✓ del servicio · mcp.idealo.com
Comparado con otros parecidos
Este
TikTok Shop
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoSíNoNoNoNo
Revisiones básicas3/34/44/45/54/44/4
LicenciaMITMITMITCC0-1.0MITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

tiktok-shop-mcp

A Model Context Protocol (MCP) server for the TikTok Shop Partner API — query orders, finance, products, analytics, and affiliate performance across multiple shops from Claude, or any other MCP client.

Built for sellers and agencies who operate TikTok Shops and want their AI assistant to answer questions like *"what did the US shop sell yesterday?"*, *"which SKUs are trending this week?"*, or *"pull the settlement statements for June"* — directly against the official API, with no browser scraping.

Features

  • Multi-shop — configure any number of shops in one JSON file; every tool takes an optional seller_name (partial match) to pick the shop
  • 32 tools covering orders, finance, product catalog and listing lookups, shop/video/SKU analytics, affiliate best-sellers, returns/cancellations, and gated product writes
  • Human-friendly dates — pass start_date=2026-07-01 + an IANA timezone instead of unix timestamps; the server handles conversion
  • Token lifecycle — inspect expiry and refresh access tokens (single shop or all shops) without leaving the conversation
  • Resilient by default — all requests go through mcp-retry (exponential backoff + jitter on 429/5xx/network errors)
  • Read-only by default — product write tools exist (image upload, create, partial edit, activate/deactivate), but every one of them refuses until you list the shop's exact name in TIKTOK_SHOP_WRITE_SHOPS, and each defaults to a dry run. See Product writes. Otherwise the only thing the server writes is your own shops.json, when it refreshes tokens, with owner-only (0600) permissions. If you never need writes, authorize the Partner Center app with read scopes only

Tools

GroupTools
Shops & authlist_shops · refresh_token · refresh_all_tokens
Ordersget_shop_orders · get_order_detail · search_returns · search_cancellations
Financeget_shop_statements · get_shop_transactions
Productsget_shop_products · get_product_detail
Listing lookupsget_categories · get_category_attributes · get_category_rules · get_brands · get_warehouses
Product writes (opt-in, see below)upload_product_image · create_product · partial_edit_product · activate_products · deactivate_products
Shop analyticsget_shop_performance · get_shop_performance_hourly · get_shop_products_performance · get_product_performance · get_shop_videos_performance · get_sku_performance · get_customer_service_performance
Video & affiliateget_account_video_gmv · get_videos_bestselling · get_creators_bestselling · get_products_bestselling

Installation

pip install tiktok-shop-mcp

Or from source, into a virtualenv, with the direct dependencies pinned to the versions the tests run against:

git clone https://github.com/Buer2333/tiktok-shop-mcp.git

cd tiktok-shop-mcp python3 -m venv .venv .venv/bin/pip install -r requirements.txt .venv/bin/pip install --no-deps -e .

requirements.txt pins the direct runtime dependencies to exact versions, including mcp-retry, which wraps every API call and so sees your tokens. Transitive dependencies (pydantic, starlette, and so on) are not pinned; for a fully reproducible install, generate a lock file with pip-compile --generate-hashes. Bump a pin only after reading what changed in that release.

Compatibility

Works with both mcp 1.x and 2.x. mcp 2.0 renamed FastMCP to MCPServer (mcp.server.mcpserver) and turned mcp.server.fastmcp into a raising stub; server.py imports via a try-v2-except-v1 shim. Tests pass on 1.28.1 and 2.1.1; requirements.txt pins 2.1.1.

Configuration

Credentials live in a JSON file outside the repo (default ~/.config/tiktok-mcp/shops.json, override with the TIKTOK_SHOP_CONFIG env var). The server never reads a shops.json from the project folder, so a copy there can't be picked up and synced or committed by accident. Keep the file owner-only:

chmod 700 ~/.config/tiktok-mcp && chmod 600 ~/.config/tiktok-mcp/shops.json

The setup scripts leave token backups (shops.json.bak.* and a recovery/ folder) next to it; delete them once your shops are working. A small shops.json.lock file also lives there; it is how the server, the cron refresher, and the setup scripts avoid writing the file at the same time, so leave it be.

[

{ "seller_name": "MY SHOP US", "seller_base_region": "US", "app_key": "...", "app_secret": "...", "access_token": "TTP_...", "refresh_token": "TTP_...", "shop_id": "...", "shop_cipher": "..." } ]

You get app_key / app_secret by creating an app on the TikTok Shop Partner Center, then authorize your shop(s) to obtain tokens. shop_id / shop_cipher are returned by the authorized-shops endpoint; the bundled probe_authorized_shops.py script can fetch them for you.

The three *_bestselling tools need a shop whose app has the Bestsellers scope. The lists are platform-wide, so one such shop is enough: set TIKTOK_SHOP_BESTSELLERS_SHOP to its seller_name (partial match OK) and the tools use it whenever seller_name is omitted. Without it they fall back to the first shop in shops.json.

Adding a shop
TIKTOK_SHOP_APP_SECRET=... .venv/bin/python add_or_update_shop.py "<full_callback_url>" --seller-name "MY SHOP"

TIKTOK_SHOP_APP_SECRET is only needed for the first shop on an app; after that the script reads it from the existing entry. The callback URL carries app_key and code. The code is single-use and starts with TTP_, while an app secret is 40 hex characters, so they are easy to tell apart.

To keep one business's shops apart from another's, point TIKTOK_SHOP_CONFIG at its own file for both this script and the server. Backups and the recovery/ folder follow that path.

Token lifetime
  • Access token: lasts about 7 days. An expired token gets 401 / 105002 Expired credentials; the server then refreshes it and retries once, so MCP use needs no scheduled job.
  • Refresh token: effectively does not expire (observed expiry in 2125).
  • `access_token_expire_in` / `refresh_token_expire_in`: despite the names, these are Unix timestamps, not durations.
  • ***_expire_at in shops.json and list_shops:** real UTC dates. Entries written by older versions can show years like 2083 until their next refresh.
Claude Code
claude mcp add tiktok-shop -- tiktok-shop-mcp
Claude Desktop / other MCP clients
{

"mcpServers": { "tiktok-shop": { "command": "tiktok-shop-mcp", "env": { "TIKTOK_SHOP_CONFIG": "/path/to/shops.json" } } } }

Product writes (opt-in)

Five tools change a shop's listings. They are off unless you turn them on per shop.

ToolEndpoint (Product API 202309)Required params
upload_product_imagePOST /product/202309/images/upload (multipart)seller_name, image_path; use_case = MAIN_IMAGE (default), ATTRIBUTE_IMAGE, DESCRIPTION_IMAGE, CERTIFICATION_IMAGE, SIZE_CHART_IMAGE
create_productPOST /product/202309/productsseller_name, product (the Create Product body: title, category_id, main_images, skus, ...)
partial_edit_productPOST /product/202309/products/{id}/partial_editseller_name, product_id, changes
activate_productsPOST /product/202309/products/activateseller_name, product_ids (max 20)
deactivate_productsPOST /product/202309/products/deactivateseller_name, product_ids (max 20)

The gate. Every write tool checks, before it builds a request:

  1. seller_name is given and matches a shops.json entry exactly. The read tools' partial, case-insensitive match and first-shop fallback do not apply: "MY SHOP" will not select "MY SHOP US".
  2. That exact name is listed in the TIKTOK_SHOP_WRITE_SHOPS environment variable (comma-separated). Unset or empty means every write tool refuses, dry runs included.
{

"mcpServers": { "tiktok-shop": { "command": "tiktok-shop-mcp", "env": { "TIKTOK_SHOP_WRITE_SHOPS": "MY SHOP US" } } } }

Dry run first. dry_run defaults to true: the tool returns the method, path and JSON body it would send (no token, signature or app key) and makes no HTTP request. Pass dry_run=false to send. A real send then:

  • goes out once. Write requests skip the automatic retry used for reads, because a create that timed out may still have gone through. On a network error the result says the outcome is unknown; read the product before trying again.
  • reads the product back (GET /product/202309/products/{id}) and returns it as read_back. After partial_edit_product the read-back asks for the version under review, since TikTok Shop keeps the old version live until the edit passes audit. After activate_products / deactivate_products it returns each product's status, and errors lists per-product failures that come back with code 0.

What the tools will not do.

  • No full Edit Product (PUT .../products/{id}): it overwrites every field the body leaves out.
  • partial_edit_product refuses skus. The API treats each top-level field as a unit, so a skus list you send stands in for the whole property; the docs do not say what happens to SKUs left out of it (they may be removed), and SKUs carry inventory. It also refuses listing_platforms and anything not on its list (title, description, brand_id, main_images, product_attributes, package_weight, package_dimensions, video, certifications, size_chart, search_terms, key_product_features, external_product_id, save_mode, locale).
  • No stock or price updates, product deletion, or anything touching orders, finance or promotions.

Things to know before sending.

  • Partial Edit leaves omitted top-level fields alone, but an object or list you do send replaces that whole property: leave out one product_attributes entry or one package_dimensions value and it is blanked. Send the full property.
  • Edits other than price and inventory go back to audit. So do activations (status PENDING). New products are audited after creation.
  • create_product sets each SKU's opening inventory (warehouse_id from get_warehouses, quantity). If another system syncs your stock, make the opening numbers match it; after creation, leave stock to that system.
  • US, EU and SEA shops must use category_version v2; the tools default to it.
  • The Partner Center app needs the Product Basic (seller.product.basic) and Product Modify (seller.product.write) scopes; get_warehouses needs Logistics Basic (seller.logistics).

Example prompts

  • *"List my shops and when their tokens expire"*
  • *"Orders for MY SHOP US on 2026-07-18, Eastern time"*
  • *"Which creators drove the most GMV for us in the last 7 days?"*
  • *"Compare yesterday's hourly GMV curve with the day before"*
  • *"Refresh tokens for all shops"*

Architecture

tiktok_shop_mcp/

├── server.py # FastMCP app — tool definitions, date handling, error envelope ├── client.py # Signed HTTP client (HMAC-SHA256 request signing, via mcp-retry) ├── config.py # Multi-shop credential loading & resolution ├── write_guard.py # Exact-name + TIKTOK_SHOP_WRITE_SHOPS gate for write tools └── tools/ # One module per API domain (orders, finance, products, analytics…)

All tools return structured JSON. Errors come back as {"error": true, "message": …, "suggestion": …} so the model can self-correct (e.g. refresh an expired token and retry).

Disclaimer

This is an independent open-source project, not affiliated with or endorsed by T

Solo se muestra el principio; lee el resto en el repo