FastSocial Instagram Data

npx add-mcp 'https://data.fastsocial.co/mcp'

Servidor MCP de Dados do Instagram

Conecte seu assistente de IA à API de Dados do Instagram da FastSocial, e ele poderá consultar perfis públicos do Instagram, posts, reels, stories, destaques, comentários, hashtags, locais e áudio. Somente leitura: ele nunca publica, segue, curte ou envia mensagens.

O servidor é remoto. Não há nada para instalar ou executar: seu assistente conversa com

https://data.fastsocial.co/mcp

via Streamable HTTP. Na primeira conexão, uma página fastsocial.co abre no seu navegador onde você faz login e clica em Permitir.

Este repositório contém os manifestos do plugin (plugin.json, mcp.json e a cópia que o Cursor lê em .cursor-plugin/), o server.json que lista o servidor no Registro MCP oficial como io.github.FastSocialCo/instagram-data-mcp, e um manifesto LobeHub. Ele não contém código que roda na sua máquina. O código do servidor não está aqui.

Instalação

Cursor

Instale o plugin pelo cursor.directory, ou adicione o servidor ao .cursor/mcp.json (um projeto) ou ~/.cursor/mcp.json (todos os projetos):

{
  "mcpServers": {
    "instagram-data": {
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

Abra Configurações, depois MCP, e conecte. O Cursor abre a página de login da FastSocial.

Claude Code

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp

Depois execute /mcp dentro do Claude Code, escolha instagram-data e faça login.

Aplicativo Claude (web e desktop)

1. Abra Configurações, depois Conectores, e adicione um conector personalizado.
2. Cole https://data.fastsocial.co/mcp como URL do servidor.
3. Deixe o ID do cliente OAuth e o segredo vazios.
4. Conecte e faça login na página da FastSocial que abrir.

VS Code e outros clientes

Qualquer cliente que fale MCP via Streamable HTTP pode se conectar com a URL do servidor. No VS Code, adicione isto ao .vscode/mcp.json e pressione Iniciar:

{
  "servers": {
    "instagram-data": {
      "type": "http",
      "url": "https://data.fastsocial.co/mcp"
    }
  }
}

O que este plugin faz e quais dados ele envia

O plugin em si

O plugin são dois arquivos JSON que informam ao seu cliente o endereço do servidor. Ele não executa código, não tem scripts de instalação e não armazena nada. Seu cliente faz cada requisição por conta própria, diretamente para https://data.fastsocial.co/mcp via HTTPS.

O que seu cliente envia

• O handshake MCP: o nome e a versão do seu cliente, e a versão do protocolo que ele fala.
• Cada chamada de ferramenta: o nome da ferramenta e seus argumentos, que são as coisas sobre as quais você perguntou: um nome de usuário ou ID de usuário do Instagram, um link de post ou reel, uma hashtag, palavras de busca, um local, ID de áudio ou destaque, e um cursor de paginação. A lista completa está na tabela abaixo.
• Seu token de login ou chave de API, em um cabeçalho de requisição. Nunca na URL.
• Os detalhes usuais de qualquer requisição web, como seu endereço IP e o user agent do seu cliente.

Nada mais é enviado. O servidor nunca vê seus arquivos, seu editor ou sua conversa, apenas os argumentos que seu assistente coloca em uma chamada de ferramenta.

O que retorna

Dados públicos do Instagram em JSON, além de meta.credits_remaining. Fotos e vídeos retornam como links, não como arquivos. Contas privadas retornam um erro private_account. Os donos de contas do Instagram podem optar por sair; depois disso, a API retorna 451 opted_out para a conta deles.

Somente leitura

Toda ferramenta lê. Nenhuma altera nada no Instagram. A única coisa que uma chamada altera é o seu próprio saldo de créditos do mês. O servidor marca toda ferramenta como readOnlyHint: true e openWorldHint: true em tools/list. Não há ferramentas que escrevam ou excluam.

Fazendo login

Na primeira vez que seu cliente se conecta, o servidor responde que precisa de login e informa onde descobrir como. Seu cliente então abre uma página em fastsocial.co no seu navegador. Lá você:

1. insere seu e-mail e o código que a FastSocial envia por e-mail,
2. vê qual aplicativo está solicitando e clica em Permitir (ou Negar).

Se você ainda não tem um plano, um plano Gratuito é criado para você quando clicar em Permitir. Você nunca digita uma senha no seu assistente, e o plugin nunca vê ou armazena suas credenciais. Seu cliente mantém os tokens que recebe. Um token de acesso dura uma hora, e seu cliente o renova com um token de atualização que dura 30 dias e muda a cada uso.

Para cortar o acesso de todos os aplicativos que você conectou, faça login em https://fastsocial.co/cart/api/account e pressione Nova chave. Os logins vinculados à chave antiga param de funcionar imediatamente.

Para desenvolvedores de clientes: a descoberta começa em https://data.fastsocial.co/.well-known/oauth-protected-resource/mcp. O servidor de autorização suporta OAuth 2.1 com PKCE (somente S256), registro dinâmico de clientes e revogação de tokens, para clientes públicos.

Usando uma chave de API em vez disso

Se seu cliente pode definir um cabeçalho, mas não pode fazer login, obtenha uma chave em https://fastsocial.co/instagram-api?ref=github e envie-a em cada requisição como X-API-Key: YOUR_KEY (ou Authorization: Bearer YOUR_KEY). Para Claude Code:

claude mcp add --transport http instagram-data https://data.fastsocial.co/mcp --header "X-API-Key: YOUR_KEY"

Mantenha a chave fora de arquivos que você faz commit.

Políticas

• Política de privacidade: https://fastsocial.co/privacy
• Termos: https://fastsocial.co/terms
• Política de uso dos dados (somente dados públicos, sem rastrear ou assediar pessoas, nada sobre menores): https://fastsocial.co/instagram-api/docs?ref=github
• Reportando um problema de segurança: SECURITY.md

As 28 ferramentas

Cada chamada custa créditos da sua cota mensal. Chamadas com falha não custam nada. Toda ferramenta é somente leitura.

Ferramenta	O que faz	Argumentos	Créditos
instagram_profile	Obter um perfil do Instagram	username ou user_id	1
instagram_user_id	Nome de usuário do Instagram para ID de usuário	username ou user_id	1
instagram_username	ID de usuário do Instagram para nome de usuário	user_id	2
instagram_check	Verificar se um handle do Instagram existe e é público	username	1
instagram_posts	Obter posts recentes do Instagram	username ou user_id, cursor	1
instagram_reels	Obter os reels do Instagram de uma conta	username ou user_id, cursor	1
instagram_tagged	Obter posts em que uma conta foi marcada	username ou user_id, cursor	1
instagram_post	Obter um post ou reel do Instagram	url ou shortcode	1
instagram_media	URLs de download para um post, reel ou carrossel	url ou shortcode	1
instagram_comments	Obter comentários em um post do Instagram	url ou shortcode	3
instagram_comment_replies	Obter respostas a um comentário do Instagram	url ou shortcode, comment_id, cursor	3
instagram_likers	Obter contas que curtiram um post do Instagram	url ou shortcode	3
instagram_insights	Calculadora de taxa de engajamento do Instagram	username ou user_id	2
instagram_followers	Obter os seguidores de uma conta	username ou user_id, cursor	3
instagram_following	Obter contas que uma conta segue	username ou user_id, cursor	3
instagram_similar	Encontrar contas semelhantes no Instagram	username ou user_id	1
instagram_stories	Ver stories do Instagram anonimamente	username ou user_id	3
instagram_highlights	Obter destaques de stories do Instagram	username ou user_id	3
instagram_highlight	Obter os itens de um destaque	id	3
instagram_search	Pesquisar contas, hashtags e locais do Instagram	q	1
instagram_hashtag	Obter posts para uma hashtag do Instagram	tag, cursor	1
instagram_place	Obter um local do Instagram	id	3
instagram_place_posts	Obter posts marcados em um local do Instagram	id, cursor	1
instagram_audio	Obter uma faixa de áudio do Instagram e os reels que a usam	id	1
instagram_audio_search	Pesquisar músicas e sons do Instagram	q	3
instagram_reels_search	Pesquisar reels do Instagram por palavra-chave	q, cursor	3
instagram_top_accounts	Ranking diário das 2.000 contas com mais seguidores	sort, limit	0
instagram_usage	Seus créditos usados e restantes neste mês	nenhum	0

Referência completa: https://fastsocial.co/instagram-api/docs?ref=github

Coisas para perguntar a ele

• "Compare a taxa de engajamento de @nasa e @spacex."
• "Baixe todos os slides deste carrossel: https://www.instagram.com/p/..."
• "Mostre-me os stories atuais de @natgeo e resuma-os."
• "Encontre 10 contas semelhantes a @humansofny."

Versão local

Se seu cliente só executa servidores locais (stdio), as mesmas ferramentas estão no PyPI como instagram-data-mcp. Não faz parte deste plugin. O código-fonte está em FastSocialCo/instagram-data-mcp-python.

Links

• API de Dados do Instagram: https://fastsocial.co/instagram-api?ref=github
• Documentação: https://fastsocial.co/instagram-api/docs?ref=github
• Especificação OpenAPI: https://fastsocial.co/instagram-api/openapi.json
• Entrada no Registro MCP: io.github.FastSocialCo/instagram-data-mcp

Licença

MIT. Veja LICENSE.