Michael Johnson
«Mostra-me o perfil de uma marca no IG, encontra as publicações mais recentes e sugere temas que valha a pena explorar». Agora pode pedir isso a um assistente de IA ligado ao jsonscraper. Lançámos um servidor MCP para IG e TikTok: o assistente obtém dados através da nossa API, apresenta-os em cartões e ajuda a passar da consulta à análise.
É útil quando precisa de estudar um criador antes de uma colaboração, comparar perfis de concorrentes, perceber as perguntas numa publicação ou reunir material para um plano de conteúdos. Descreva a tarefa com palavras correntes e o assistente escolhe as ferramentas adequadas. Não precisa de escrever código para fazer a primeira consulta.
Em 26 de outubro de 2026, disponibilizámos um servidor MCP unificado e 40 cenários prontos — 20 para cada plataforma. Em 27 de outubro, atualizámos os cartões interativos e adicionámos filtros e análises das amostras obtidas. As datas e o âmbito das alterações estão no nosso registo de versões. O endereço do servidor é https://mcp.jsonscraper.com; a ligação foi concebida para ChatGPT, Claude, Codex e clientes MCP compatíveis.
Início rápido: da licença à primeira consulta
Vai precisar de uma licença da API pretendida e de um assistente de IA com suporte para MCP. Não precisa de uma chave OpenAI separada para ligar ao jsonscraper.
- Escolha a plataforma. Adquira a IG Scraper API ou a TikTok Scraper API. Se já tiver uma licença, utilize-a: não precisa de comprar outra para usar o MCP.
- Copie a chave. Inicie sessão na conta com que comprou o produto, abra Evelode → Licenças e localize a chave da API pretendida.
- Adicione o servidor MCP. Na secção de ligações do assistente, introduza
https://mcp.jsonscraper.come escolha OAuth. Mais abaixo encontrará instruções específicas para ChatGPT, Claude e Codex. - Ligue a licença. Na página de autorização, cole a chave no cartão da sua plataforma, clique em Check key, aguarde até surgir Connected e confirme com Connect. Para duas plataformas, são necessárias as duas chaves correspondentes.
- Verifique a primeira consulta. Ative a ferramenta ligada no chat e peça para mostrar um perfil público que conheça. Comece com uma amostra pequena.
Como verificar o resultado
Por exemplo: «Mostra o perfil público @instagram no IG usando o jsonscraper MCP». A resposta deve basear-se no resultado de uma chamada à ferramenta. Num cliente com suporte para MCP Apps, os dados podem ser apresentados num cartão interativo; noutros clientes compatíveis, podem surgir como texto ou dados estruturados.
Se a chave for rejeitada, verifique a plataforma, se a licença está ativa e o limite disponível. Se a ferramenta não aparecer, conclua a autorização OAuth e ative a ligação no chat atual. Introduza a chave de licença apenas na página de ligação; não a envie na conversa com o assistente.
O que o MCP muda no trabalho quotidiano
MCP — Model Context Protocol — é uma forma de ligar ferramentas externas a um assistente de IA. Após a autorização, o assistente pode aceder aos métodos permitidos do jsonscraper, obter dados do IG ou do TikTok e utilizá-los na resposta. Em vez de procurar uma rota da API, escolher parâmetros e interpretar JSON manualmente, pode descrever a tarefa com palavras correntes: por exemplo, pedir uma breve visão geral de um perfil público ou comparar os dados já obtidos de duas contas.
O servidor unificado reúne 94 métodos da API do IG e 54 métodos da API do TikTok. A ligação de uma licença de produto dá acesso às ferramentas da plataforma correspondente; duas licenças dão acesso a ambas. Os planos e as quotas continuam separados: as consultas do IG consomem a quota do IG e as consultas do TikTok consomem a quota do TikTok. O MCP utiliza as chaves jsonscraper das APIs selecionadas e realiza a autorização na sua página OAuth.
Cartões que ajudam a interpretar os resultados
Os dados podem ser consultados não só como texto ou JSON. Os clientes compatíveis com MCP Apps disponibilizam cartões interativos de perfis, publicações e vídeos, seguidores, comparações e resultados de cenários. O cartão de perfil facilita a consulta das principais informações obtidas; no cartão de publicações, pode abrir uma publicação e consultar os comentários, se fizerem parte da amostra. A apresentação de seguidores utiliza a última página obtida e mostra até 50 contas; o cartão de vídeos mostra até 12 vídeos devolvidos.
O cartão de comparação permite colocar lado a lado perfis do IG e do TikTok obtidos anteriormente, e os cartões de cenários mostram o material em que a análise se baseia. Comece por comparar os indicadores disponíveis dos perfis. Se quiser explorar o conteúdo, peça em seguida uma página de publicações de cada perfil: assim, o assistente terá material para uma análise mais detalhada.
A ordenação e os filtros são aplicados localmente às publicações já obtidas: pode selecionar um formato, definir um limite de visualizações ou um período e, em seguida, analisar os melhores resultados da amostra. Estas ações não pedem novas páginas à API. A interatividade visual depende do suporte do cliente para MCP Apps; se não houver suporte, o assistente recebe dados estruturados e pode trabalhar com eles da forma habitual. Consulte a demonstração interativa dos cartões e o catálogo de 40 cenários.
Onde obter uma chave para a ligação
Se já utiliza o jsonscraper, pode usar uma chave ativa da API pretendida. Se está a conhecer o serviço pela primeira vez, comece por adquirir o acesso:
- Abra a página da API do IG ou da API do TikTok, conforme a plataforma com que pretende trabalhar.
- Consulte os planos atuais e avance para a compra do acesso. As licenças são vendidas através da Evelode: separadamente para a API do IG e para a API do TikTok.
- Depois da compra, inicie sessão na sua conta Evelode e abra as suas licenças. Localize o produto pretendido e copie a respetiva chave.
Para trabalhar com ambas as plataformas, precisará de duas licenças. Cada uma mantém o seu próprio plano e limite de pedidos; pode ligá-las ao mesmo servidor MCP.
Ao adicionar o servidor no assistente, abre-se a página de autorização do jsonscraper. OAuth é o processo que associa a sua licença a esta ligação. Cole a chave copiada no cartão do produto correspondente: IG no campo IG e TikTok no campo TikTok. Clique em Check key, aguarde pelo estado Connected e selecione Connect. Para adicionar a segunda plataforma mais tarde, repita a autorização com a chave do outro produto.
Esta ligação não exige a palavra-passe do IG ou do TikTok, uma aplicação de programador Meta/TikTok nem uma chave OpenAI. Se o cliente apresentar campos adicionais Client ID e Client Secret, deixe-os vazios: o registo do cliente é automático. A chave de licença é introduzida na página de autorização do jsonscraper; não a envie no chat nem a inclua num pedido normal ao assistente.
O percurso principal: ligar ao ChatGPT
- No ChatGPT, abra Plugins → Add → Add custom MCP server.
- Introduza o nome jsonscraper, o endereço
https://mcp.jsonscraper.come escolha OAuth como método de autorização. - Crie a ligação como plugin, abra o respetivo cartão e selecione Install.
- Na janela de autorização do jsonscraper que se abrir, adicione a chave ao cartão do produto pretendido, valide-a e confirme a ligação.
- Regresse ao chat e selecione jsonscraper através de
@; depois, formule a primeira consulta com um limite de volume claro.
Os nomes das opções e a disponibilidade da ligação podem variar consoante o cliente e o espaço de trabalho. Mantemos as instruções e as opções de ligação atualizadas na página do MCP; os princípios gerais de ligação MCP também estão descritos na documentação da OpenAI.
Também preparámos um plugin ZIP pronto a usar e instruções de instalação para a aplicação de computador do ChatGPT. Escolha esta opção se quiser importar o pacote. O ZIP destina-se apenas à aplicação de computador; o percurso principal acima descreve a ligação a um servidor remoto por URL.
Claude e Codex CLI
No Claude, abra Customize → Connectors → + Add → Add custom connector. Introduza o nome jsonscraper e o mesmo endereço https://mcp.jsonscraper.com, selecione Add ou Connect e conclua a autorização OAuth na página do jsonscraper. No chat, ative o conector no menu de ferramentas — normalmente, o percurso começa no botão + e na secção Connectors. Os nomes dos menus podem variar consoante as funcionalidades disponíveis e as definições do espaço de trabalho.
Para o Codex CLI, adicione o servidor e autorize-o com estes comandos:
codex mcp add jsonscraper --url https://mcp.jsonscraper.com
codex mcp login jsonscraperEm seguida, inicia-se o processo OAuth. Quando estiver concluído, o Codex poderá utilizar as ferramentas permitidas pela licença.
Primeiras consultas: comece com um volume pequeno
Os cenários prontos poupam tempo na definição da sequência de ações. O catálogo inclui tarefas para obter uma visão geral de perfis, encontrar e analisar publicações, concorrentes, comentários, autores e ideias para conteúdos. Seguem-se alguns pedidos que pode adaptar. Substitua os nomes dos perfis e o link da publicação pelos seus.
Verifica as licenças de IG e TikTok ligadas. Mostra o estado, o limite disponível e o saldo de cada uma. Não consultes dados das redes sociais.
A verificação das licenças indica o estado das ligações e das quotas sem consumir a quota das APIs das redes sociais. Se apenas tiver ligado um produto, verifica essa licença.
Faz uma análise geral do perfil público do IG @nome_do_perfil: dados principais e uma página de publicações. Mostra o resultado num cartão. Faz no máximo dois pedidos à API e indica o tamanho da amostra obtida.
Pode indicar um perfil do TikTok em vez do IG. Este início permite consultar o perfil e um conjunto limitado de publicações; depois, pode decidir que pergunta fazer a seguir.
Compara os perfis públicos do IG @perfil_1 e @perfil_2. Faz um pedido de perfil para cada conta e mostra um cartão de comparação. Compara os indicadores disponíveis e assinala os campos em falta como desconhecidos.
Num cartão, pode comparar de dois a quatro perfis obtidos anteriormente, incluindo perfis de plataformas diferentes. Para comparar IG com TikTok, ligue ambas as licenças.
Analisa os comentários desta publicação do IG [insere o link]: obtém uma página de comentários e limita-te a dois pedidos à API, incluindo a identificação da publicação. Agrupa perguntas e temas recorrentes e cita apenas exemplos presentes nos comentários obtidos.
Esta análise ajuda a identificar perguntas sobre o produto, temas de discussão e formulações que podem ser consideradas na publicação seguinte. O resumo refere-se aos comentários carregados; pode ampliar a amostra com um pedido separado.
Com base na amostra de publicações já obtida, propõe três ideias de conteúdo para testar. Para cada ideia, indica quais publicações da amostra a inspiraram; não faças novos pedidos à API.
Os cartões de cenários podem associar ideias a publicações de origem específicas. As sugestões do assistente são hipóteses para testes editoriais: pode ver, junto de cada uma, quais publicações serviram de ponto de partida. O mesmo princípio de trabalho aplica-se aos concorrentes: comece por definir uma amostra limitada de perfis ou publicações e, depois, peça conclusões que indiquem os dados em que se baseiam.
Quotas e indicadores: o que ter em conta nas conclusões
Uma chamada normal a um método de dados faz um pedido à API do produto correspondente e é contabilizada na respetiva licença. O passo seguinte da paginação é mais um pedido; por isso, numa tarefa grande, convém definir antecipadamente um limite, como o número de páginas ou o máximo de chamadas, e permitir que o processo pare ao atingir esse limite. A verificação da licença não consome a quota de dados das redes sociais. Os cartões, filtros e a ordenação reutilizam os dados já obtidos e não fazem novos pedidos.
Qualquer resumo descreve a amostra efetivamente obtida. Uma página de publicações não representa todo o conteúdo, e a última página de seguidores obtida não representa toda a audiência. Para abranger mais dados, faça uma recolha gradual e limitada; no pedido final, peça ao assistente que indique o número e a composição dos registos utilizados.
Os indicadores também dependem da existência de dados de origem suficientes. A taxa de interação por visualizações (ER) é calculada quando a publicação tem valores disponíveis para gostos, comentários, partilhas e um número positivo de visualizações. A comparação de visualizações relativas é possível quando existem pelo menos cinco publicações do mesmo autor e formato; a referência é a mediana desse grupo. Se um valor estiver em falta, permanece desconhecido, não passa a zero. Por isso, é útil pedir ao assistente que explique quais os campos e registos incluídos no cálculo.
Perguntas frequentes
Preciso de uma chave OpenAI ou da palavra-passe da rede social?
Não. Para o jsonscraper MCP, utilize a chave de licença do produto jsonscraper pretendido e introduza-a na página OAuth do jsonscraper. Não precisa das palavras-passe do IG nem do TikTok.
Posso ligar apenas o IG ou apenas o TikTok?
Sim. Uma licença dá acesso às ferramentas da respetiva plataforma; duas licenças dão acesso a ambas. Os produtos têm planos e quotas próprios.
Os filtros e a verificação da licença consomem quota?
A verificação da licença não consome a quota das APIs das redes sociais. Os filtros, a ordenação e os cartões trabalham com dados já obtidos; as chamadas normais aos métodos de dados e as novas páginas consomem a quota do produto correspondente.
Posso instalar o ZIP num browser ou num telemóvel?
O ZIP instala-se na aplicação de computador do ChatGPT. Para a versão Web, siga as instruções para ligar o servidor remoto; a disponibilidade de plugins e das respetivas funcionalidades na aplicação móvel depende das capacidades do cliente e das definições do espaço de trabalho.
Ligue-se e faça a primeira pergunta
Abra a demonstração dos cartões, escolha um cenário interessante e veja como é apresentado o resultado. Depois, avance para a ligação do jsonscraper MCP: adicione a chave, escolha um assistente e faça a primeira consulta sobre um perfil com que trabalhe. Pode copiar exemplos prontos do catálogo de cenários.
Se mais tarde quiser integrar o mesmo acesso na sua aplicação ou fluxo de trabalho, estão disponíveis SDK para Python, Node.js, PHP, Go, Java e C#/.NET, listados na página de ferramentas para programadores. Para começar, basta ligar o MCP ao assistente que já utiliza; a integração programática pode ficar para quando as necessidades aumentarem.
