TG Market

npx add-mcp 'https://tgmarket.io/mcp'

Conecte o TG Market ao Claude, Cursor, VS Code e outros assistentes que suportam o Model Context Protocol (MCP). O assistente pesquisa canais, lê cards e métricas, busca posts e calcula preços de exportação para você — com sua chave de API e os mesmos preços da API REST.

URL do servidor (transporte: Streamable HTTP):

https://tgmarket.io/mcp

Autorização. Contas gratuitas com e-mail verificado conectam via OAuth (veja abaixo): uma avaliação de 20 chamadas por dia, sem contatos de anúncios, profundidade de busca Free. Em planos pagos, as chamadas consomem créditos. Uma chave de API no cabeçalho Authorization: Bearer exige um plano pago; sem uma chave válida ou login OAuth, o servidor retorna 401. Crie uma chave em API keys

claude.ai e ChatGPT conectam sem chave, via OAuth: você faz login no TG Market e permite o acesso.

Conectar

claude.ai e ChatGPT (conectores, OAuth)

• claude.ai: Configurações → Conectores → Adicionar conector personalizado, URL https://tgmarket.io/mcp. Clique em Conectar, faça login no TG Market e clique em Permitir.
• ChatGPT (modo desenvolvedor): Configurações → Apps e Conectores → Criar, URL https://tgmarket.io/mcp, autenticação OAuth. Faça login no TG Market e clique em Permitir.

Nenhuma chave de API é necessária: o acesso é concedido ao aplicativo específico e cobrado como uma chave de API. No plano Free, funciona como uma avaliação: algumas solicitações por dia com resultados limitados. O acesso dura até 180 dias e pode ser revogado a qualquer momento em Painel → Chaves de API → Aplicativos conectados.

Claude Code

claude mcp add --transport http tgmarket https://tgmarket.io/mcp \
  --header "Authorization: Bearer mk_live_ab12cd34_xxxxxxxxxxxxxxxx"

Cursor (~/.cursor/mcp.json ou .cursor/mcp.json no projeto)

{
  "mcpServers": {
    "tgmarket": {
      "url": "https://tgmarket.io/mcp",
      "headers": { "Authorization": "Bearer mk_live_ab12cd34_xxxxxxxxxxxxxxxx" }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "tgmarket": {
      "type": "http",
      "url": "https://tgmarket.io/mcp",
      "headers": { "Authorization": "Bearer mk_live_ab12cd34_xxxxxxxxxxxxxxxx" }
    }
  }
}

Claude Desktop e clientes sem cabeçalhos personalizados — via ponte mcp-remote

{
  "mcpServers": {
    "tgmarket": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://tgmarket.io/mcp", "--header", "Authorization:${MK_AUTH}"],
      "env": { "MK_AUTH": "Bearer mk_live_ab12cd34_xxxxxxxxxxxxxxxx" }
    }
  }
}

Qualquer outro cliente: transporte Streamable HTTP, a URL acima, cabeçalho Authorization: Bearer <key>.

Mantenha a chave em segredo: tudo o que o assistente solicita é cobrado do seu saldo. Crie uma chave separada para o assistente para que você possa revogá-la de forma independente.

Ferramentas

Ferramenta	O que faz	Custo
search_channels	Busca canais por texto e filtros (idioma, categorias, inscritos, ER, crescimento, anúncios…), até 100 por página com cursor	solicitação + linhas
count_channels	Conta canais correspondentes, audiência total e facetas por idioma, categoria e tamanho	solicitação
get_channel	Card do canal por nome de usuário ou ID: campos base, métricas, contatos de anúncios	solicitação + linha
get_channel_history	Inscritos diários, visualizações, ER e alcance	solicitação + Histórico
get_channel_posts	Posts recentes de um canal	solicitação + posts
search_posts	Busca de texto completo em posts com filtros de canal	solicitação + posts
keyword_trend	Menções de palavra-chave ao longo do tempo: posts, canais e visualizações por dia ou semana	solicitação + 0,01 por ponto
quote_export	Preço de exportação antes de pedir: linhas, linhas gratuitas, descontos, total	solicitação
list_categories	Árvore de categorias para filtros	gratuito
list_languages	Idiomas com contagens de canais	gratuito
get_usage	Saldo, plano, limite de taxa e uso	gratuito

Cobrança e limites

• O servidor MCP é um wrapper fino sobre a API REST v1: os mesmos preços, o mesmo limite de taxa (compartilhado com solicitações REST nesta chave) e o mesmo limite diário de canais únicos.
• Linhas são cobradas pela taxa do conjunto de campos; um canal pelo qual esta chave já pagou nos últimos 30 dias é gratuito — tanto na REST quanto no MCP.
• Cada resultado de ferramenta mostra quantos créditos a chamada custou: credits_charged.
• Exportações não são pedidas via MCP: o assistente apenas calcula o preço (quote_export). Faça o pedido no site ou via POST /v1/exports.
• Quando o saldo acaba ou o limite de taxa é atingido, a ferramenta retorna um erro com o mesmo código da API REST (payment_required, rate_limited…).

Exemplos de solicitações

• “Encontre canais de criptomoedas em inglês com 10–100 mil inscritos e ER acima de 5%, ordenados por crescimento em 30 dias.”
• “Mostre o histórico de inscritos de @durov nos últimos 90 dias e compare com canais semelhantes.”
• “Quanto custaria uma exportação de todos os canais de notícias em hindi com métricas?”

Documentação da API REST →