InsightSocial

npx add-mcp 'https://api.insightsocial.app/mcp'

insightsocial

A CLI oficial e o servidor MCP para a API InsightSocial: dados públicos ao vivo de 25 plataformas com uma única chave: Instagram, TikTok, LinkedIn, Facebook, YouTube, X, Reddit, Threads, Pinterest, Bluesky, Truth Social, Snapchat, Telegram, Twitch, Kick, Rumble, Kwai, Douyin, Xiaohongshu (RedNote), Quora, TikTok Shop, Weibo, Zhihu, Substack e Nextdoor.

• Mais de 300 endpoints: perfis, e-mails públicos, posts, reels, comentários, seguidores, curtidores, hashtags, busca, páginas de empresas, empregos, anúncios, transcrições, produtos de loja e listagens de negócios locais.
• Um único esquema entre plataformas: um vídeo do TikTok e um post do Instagram retornam com os mesmos campos (post.url, post.kind, post.engagement.likes, post.language), e unavailable lista qualquer campo que uma resposta não conseguiu preencher. A CLI e o servidor MCP solicitam esquema 2 em cada chamada.
• Preço por endpoint, cobrado por chamada. Resultados vazios, chamadas com falha e repetições idempotentes são gratuitos.
• Feito para agentes. Cada resultado é salvo por completo, e você o re-fatia localmente com jq gratuitamente, então uma página de 50 KB nunca acaba no seu contexto.

Início rápido

npx -y insightsocial init              # sign in through your browser, install the agent skill, show MCP setup
npx -y insightsocial search instagram followers
npx -y insightsocial run /v1/instagram/profile -p handle=natgeo
npx -y insightsocial view --last --jq '.data.author | {username, followers}'

init e login fazem seu login pelo navegador: eles abrem a página de login e imprimem um código curto, você digita o código lá e clica em Permitir, e uma chave com o nome desta máquina é salva. A CLI então imprime em qual conta você entrou. Para usar uma chave que você já tem, passe --api-key. Novas contas incluem chamadas gratuitas.

Use a partir de um agente de IA

Plugin Claude Code

/plugin marketplace add insightsocial/skills
/plugin install insightsocial@insightsocial

Isso instala a skill e o servidor MCP juntos, a partir de insightsocial/skills. Execute npx -y insightsocial login uma vez para que o servidor encontre sua chave.

Servidor MCP (qualquer cliente)

claude mcp add insightsocial --scope user -- npx -y insightsocial mcp

{
  "mcpServers": {
    "insightsocial": { "command": "npx", "args": ["-y", "insightsocial", "mcp"] }
  }
}

O servidor lê a chave salva por insightsocial login, então a configuração não contém segredo. Você também pode passar INSIGHTSOCIAL_API_KEY em seu env. Sem uma chave, busca e descrição ainda funcionam.

Nada para instalar: as mesmas ferramentas estão hospedadas em https://api.insightsocial.app/mcp. Claude, ChatGPT e outros clientes que suportam fazem login com OAuth; outros enviam a chave como Authorization: Bearer. Veja documentação MCP.

Ferramenta	O que faz
search_endpoints	Encontra endpoints por palavras-chave e plataforma. Gratuito.
describe_endpoint	Entradas, valores permitidos, um exemplo e o preço de um endpoint. Gratuito.
call_endpoint	Busca dados. Salva a resposta completa e retorna um result_id com uma visão reduzida (10 itens por padrão) e um next_call pronto para a próxima página.
read_result	Re-fatia um resultado salvo com jq, campos, max_items ou um esboço com tamanhos. Gratuito.
get_credits	Saldo, plano e uso. Gratuito.

insightsocial init --yes escreve a entrada MCP no Claude Code, Codex e Cursor para você.

Comandos

Comando
init [--yes] [--no-skills]	Salva uma chave, instala a skill para agentes detectados, imprime ou escreve a configuração MCP.
login [--api-key k] [--no-browser] / logout	Login pelo navegador (ou salva uma chave que você passa) / remove a chave.
search <words> [--platform p]	Encontra endpoints. Gratuito.
list [--platform p]	Cada endpoint com seu preço. Gratuito.
describe <path>	Entradas, exemplo e preço. Gratuito.
run <path> -p name=value …	Chama um endpoint. Salva em ./.insightsocial/. Opções: --input <json>, -i file, --idempotency-key, --fresh, --max-credits N, -o file, --json, e os sinalizadores de formatação abaixo.
view [file] [--last [endpoint]]	Re-formata um resultado salvo. Sem rede, sem cobrança.
credits	Saldo e uso. Gratuito.
mcp	Inicia o servidor MCP via stdio.

Sinalizadores de formatação (run e view) reduzem apenas o que é impresso; o arquivo salvo é sempre completo:

• --jq <expr>: jq real (incluído, nada para instalar) sobre a resposta salva. Caminhos começam em .data.
• --fields a,b.c: mantém essas chaves em cada item. Caminhos com pontos descem.
• --max-items N: mostra no máximo N itens.
• --summary: a estrutura com tamanhos em bytes, para você ver o que é grande antes de puxar.

Paginação: quando há outra página, run imprime o comando exato de next. Cada página é uma chamada cobrada separadamente.

Precificar uma chamada antes: -p dry_run=1 (ou true) em qualquer endpoint retorna a cotação e não cobra nada. Quando uma resposta não consegue preencher um campo que a plataforma normalmente tem, run o imprime sob missing; esse nulo significa desconhecido, não zero.

Configuração

Chave	--api-key, depois INSIGHTSOCIAL_API_KEY, depois ~/.insightsocial/config.json (modo 600)
INSIGHTSOCIAL_BASE_URL	Padrão é https://api.insightsocial.app
INSIGHTSOCIAL_HOME	Padrão é ~/.insightsocial (config, cache de catálogo, resultados MCP)

Desenvolvimento

npm install
npm run check      # build + unit tests, no network and no key needed

Licença

MIT