ScraperSocial — Social Media Data MCP Server
Perfis públicos, posts, comentários, busca e transcrições do TikTok, Instagram, LinkedIn, YouTube, X, Reddit e mais 26 plataformas como JSON limpo. 14 ferramentas MCP, OAuth 2.1, servidor remoto em mcp.scrapersocial.com. 32 habilidades de agente no ClawHub, MIT-0. Plano gratuito: 100 créditos, sem cartão.
Documentação
social-media-api-skills: habilidades de API de mídia social para agentes de IA
Um kit de ferramentas de API de mídia social para agentes de IA. Essas habilidades permitem que Claude, ChatGPT, Cursor ou qualquer loop de agente personalizado leia dados públicos de 33 plataformas — a API do TikTok para transcrições de vídeo, a API do Instagram para reels e hashtags, a API do LinkedIn para perfis e dados de empresas, a API do YouTube para transcrições e comentários, além de Reddit, X, Facebook, Amazon, Google e muito mais — por meio de uma única chave e um envelope JSON. Também há um servidor MCP hospedado, caso prefira não instalar nada.
227 endpoints em 33 plataformas
Comece gratuitamente: ao se cadastrar, você ganha 100 créditos, sem necessidade de cartão. Node.js puro. Sem dependências. Licença MIT-0.
Instalação
A maioria das pessoas quer a habilidade abrangente — uma única habilidade que alcança todas as 33 plataformas:
# OpenClaw (via ClawHub)
npx clawhub@latest install social-media-api
# Hermes Agent
hermes skills install skills-sh/nikhonit/social-media-api-skills/skills/social-media-api
# Generic agent skills (Claude Code, Cursor, Cline) — installs every skill in the repo
npx skills add nikhonit/social-media-api-skills
Ou instale uma plataforma, quando você já sabe qual precisa. Cada habilidade de plataforma está no ClawHub sob um slug com prefixo scrapersocial-:
npx clawhub@latest install scrapersocial-tiktok
npx clawhub@latest install scrapersocial-instagram
npx clawhub@latest install scrapersocial-linkedin
npx clawhub@latest install scrapersocial-twitter
npx clawhub@latest install scrapersocial-reddit
npx clawhub@latest install scrapersocial-threads
npx clawhub@latest install scrapersocial-facebook
npx clawhub@latest install scrapersocial-amazon
npx clawhub@latest install scrapersocial-app-store
npx clawhub@latest install scrapersocial-bluesky
npx clawhub@latest install scrapersocial-github
npx clawhub@latest install scrapersocial-google
npx clawhub@latest install scrapersocial-google-finance
npx clawhub@latest install scrapersocial-google-maps
npx clawhub@latest install scrapersocial-google-news
npx clawhub@latest install scrapersocial-google-play
npx clawhub@latest install scrapersocial-google-shopping
npx clawhub@latest install scrapersocial-google-trends
npx clawhub@latest install scrapersocial-hacker-news
npx clawhub@latest install scrapersocial-kwai
npx clawhub@latest install scrapersocial-linkme
npx clawhub@latest install scrapersocial-linktree
npx clawhub@latest install scrapersocial-naver
npx clawhub@latest install scrapersocial-pinterest
npx clawhub@latest install scrapersocial-polymarket
npx clawhub@latest install scrapersocial-snapchat
npx clawhub@latest install scrapersocial-spotify
npx clawhub@latest install scrapersocial-tiktok-shop
npx clawhub@latest install scrapersocial-tripadvisor
npx clawhub@latest install scrapersocial-trustpilot
npx clawhub@latest install scrapersocial-truth-social
npx clawhub@latest install scrapersocial-twitch
npx skills add nikhonit/social-media-api-skills instala todas as habilidades do repositório de uma só vez. As habilidades por plataforma incluem validação de argumentos, custos por endpoint e orientações sobre quando não gastar créditos; a abrangente troca isso por alcance.
Habilidades neste repositório
| Habilidade | Plataforma | Endpoints | O que cobre |
|---|---|---|---|
| amazon-api | Amazon | 4 | Detalhes de produto, busca de produtos, avaliações e listagens de vendedores. |
| app-store-api | App Store | 6 | Metadados de apps, avaliações, busca por palavras-chave e rankings por categoria. |
| bluesky-api | Bluesky | 3 | Perfis públicos, timelines de posts e busca por palavras-chave. |
| facebook-api | 23 | Transcrições, estatísticas de páginas, comentários, reels, anúncios, marketplace e eventos. | |
| github-api | GitHub | 11 | Repositórios, commits, contribuidores, issues, releases, perfis e tendências. |
| google-api | 5 | Resultados de busca, informações do Perfil da Empresa, avaliações e anúncios de empresas. | |
| google-finance-api | Google Finance | 3 | Cotações, histórico de preços e busca de instrumentos. |
| google-maps-api | Google Maps | 4 | Detalhes de lugares, busca de lugares, fotos e descoberta de contatos. |
| google-news-api | Google News | 1 | Busca por palavras-chave em manchetes e fontes de notícias. |
| google-play-api | Google Play | 4 | Metadados de apps Android, avaliações, busca por palavras-chave e categorias. |
| google-shopping-api | Google Shopping | 1 | Busca de produtos entre lojistas, com preços. |
| google-trends-api | Google Trends | 2 | Interesse ao longo do tempo e consultas relacionadas em alta. |
| hacker-news-api | Hacker News | 4 | Histórias, threads de comentários, perfis de usuários e busca por palavras-chave. |
| instagram-api | 23 | Transcrições de reels, estatísticas de perfis e posts, comentários, hashtags e locais. | |
| kwai-api | Kwai | 3 | Perfis de criadores, listagens de posts e consultas de vídeos individuais. |
| linkedin-api | 38 | Perfis e 20 sub-recursos, empresas, busca de vagas e pessoas, posts e anúncios. | |
| linkme-api | Linkme | 1 | Resolve uma página Linkme para seus links e detalhes de perfil. |
| linktree-api | Linktree | 1 | Resolve uma página Linktree para seus links e detalhes de perfil. |
| naver-api | Naver | 4 | Busca em blog, café, local e compras no principal portal da Coreia. |
| pinterest-api | 3 | Detalhes de pins, busca por palavras-chave e contagens de salvamentos por URL. | |
| polymarket-api | Polymarket | 1 | Listagens de mercados de previsão e probabilidades atuais. |
| reddit-api | 8 | Posts, threads de comentários, listagens de subreddits, perfis de usuários e busca. | |
| snapchat-api | Snapchat | 1 | Consultas de perfis públicos de criadores. |
| spotify-api | Spotify | 6 | Faixas, álbuns, artistas, faixas mais tocadas, playlists e busca. |
| threads-api | Threads | 5 | Perfis, timelines de posts, estatísticas de posts e busca por palavras-chave. |
| tiktok-api | TikTok | 16 | Transcrições, resumos, estatísticas de canais, comentários, busca por hashtag e músicas. |
| tiktok-shop-api | TikTok Shop | 5 | Detalhes de produtos, avaliações, catálogos de lojas e vitrines de criadores. |
| tripadvisor-api | Tripadvisor | 2 | Busca de hotéis, restaurantes e atrações com listagens de avaliações. |
| trustpilot-api | Trustpilot | 1 | Listagens de avaliações de empresas. |
| truth-social-api | Truth Social | 2 | Perfis públicos e timelines de posts de usuários. |
| twitch-api | Twitch | 3 | Perfis de streamers, clipes e listagens de vídeos. |
| twitter-api | X (Twitter) | 7 | Transcrições, resumos de IA, estatísticas de posts, perfis, tweets e busca. |
| youtube-api | YouTube | 26 | Transcrições, legendas, estatísticas de vídeos e canais, comentários, Shorts e busca. |
| social-media-api | Todas as plataformas | 227 | Descubra e chame qualquer endpoint documentado em todas as fontes, sociais e web. |
Início rápido
# 1. Get a key — 100 free credits, no card
open https://scrapersocial.com/signup
# 2. Export it
export SCRAPERSOCIAL_KEY=sk_live_...
# 3. Run any script
node skills/github-api/scripts/get_profile.js torvalds
Nota: nenhuma amostra de saída capturada foi commitada ainda. O formato de resposta mostrado abaixo é retirado da especificação OpenAPI — não é uma chamada registrada. Execute
SCRAPERSOCIAL_KEY=... node tools/capture.mjspara registrar a saída real e regenerar.
Toda resposta usa o mesmo envelope:
{
"data": {},
"meta": { "count": 20, "next_cursor": "..." },
"request_id": "a18e4ef88ad4b00b"
}
data é um objeto para endpoints de entidade única e um array para os paginados. meta aparece apenas em respostas paginadas. Mantenha request_id — é assim que o suporte rastreia uma chamada.
Erros seguem a mesma disciplina:
{
"error": {
"code": "invalid_url",
"message": "...",
"hint": "...",
"request_id": "..."
}
}
Chamadas com falha não são cobradas.
Funciona com
Estes são scripts Node.js simples com um contrato documentado, então qualquer coisa que possa executar um comando pode usá-los.
- Claude Code / Claude Skills — instale com
npx skills add nikhonit/social-media-api-skills - ChatGPT — exponha um script como função ou execute-o em uma etapa de interpretador de código
- Cursor, Cline, Windsurf — coloque o repositório e deixe o agente ler
SKILL.md - Qualquer loop de agente — chame os scripts como subprocessos e analise o stdout
Instalação zero: o servidor MCP hospedado
Se preferir não incorporar nada, a ScraperSocial executa um servidor MCP hospedado que alcança os mesmos endpoints:
Claude.ai: Configurações → Conectores → Adicionar conector personalizado → https://mcp.scrapersocial.com (OAuth, sem chave para colar). Instruções completas por cliente, incluindo Windsurf, Gemini CLI e ChatGPT, estão em https://scrapersocial.com/mcp/.
claude mcp add --transport http scrapersocial https://mcp.scrapersocial.com
{
"mcpServers": {
"scrapersocial": {
"url": "https://mcp.scrapersocial.com",
"headers": { "Authorization": "Bearer sk_live_..." }
}
}
}
Ele expõe 14 ferramentas — doze ferramentas de capacidade (get_transcript, get_summary, get_post_stats, get_comments, get_comment_replies, get_profile, get_channel_posts, search, search_hashtag, get_reviews, download_media, get_trending) além de list_endpoints e call_endpoint, que juntas alcançam toda a superfície. A autenticação é OAuth 2.1 PKCE ou uma chave bearer.
Use as habilidades deste repositório quando quiser orientação por plataforma, validação de argumentos e controle sobre exatamente qual endpoint executa. Use o servidor MCP quando quiser nada instalado.
O que você recebe de volta
- JSON limpo, um envelope para cada plataforma
request_idem toda resposta, incluindo erros- Cabeçalho
x-cache: hit|missinformando se veio do cache - Controle de projeção e formato —
fieldsreduz a resposta,formatalterna entrejson,csvendjson - OpenAPI 3.1: scrapersocial.com/openapi.json
- Resumo legível por agentes: llms.txt · llms-full.txt
Todo endpoint é GET https://api.scrapersocial.com/v1/{platform}/{capability}. Parâmetros opcionais em toda chamada:
| Parâmetro | Efeito |
|---|---|
limit | Itens em endpoints paginados. Padrão 20. Os scripts limitam isso a 50 — acima disso, a API retorna um job assíncrono em vez de dados. |
cursor | next_cursor de um meta de uma resposta anterior. |
fields | Projeção, ex.: fields=id,author.name. |
format | json (padrão), csv, ndjson. |
fresh | true ignora o cache pelo mesmo custo de créditos. |
Autenticação
Todo script lê uma variável de ambiente:
export SCRAPERSOCIAL_KEY=sk_live_...
Gerencie chaves em scrapersocial.com/app/keys. Os scripts nunca imprimem sua chave — a saída de erro carrega o request_id em vez disso. Mantenha-a fora do controle de versão.
Preços
| Plano | Preço | Créditos | Limite de taxa |
|---|---|---|---|
| Gratuito | $0 | 100 únicos no cadastro, sem cartão | 20/min |
| Mensal | $5/mês | 1.000/mês, recargas $4/1k | 200/min |
| Anual | $54/ano | 12.000 antecipados, recargas $3/1k | 300/min |
| Empresarial | personalizado | personalizado | 1.500/min |
Os créditos são cobrados por item retornado em endpoints paginados e por chamada caso contrário. Os custos variam de 1 crédito (GitHub, Hacker News, Bluesky, Linktree) a 42 (resumo de IA do Instagram). O SKILL.md de cada habilidade lista o custo exato de cada endpoint que ela encapsula. Acertos de cache custam o mesmo que chamadas novas e retornam em milissegundos. Chamadas com falha não são cobradas.
FAQ
Como obtenho dados do TikTok como JSON?
Instale tiktok-api, exporte SCRAPERSOCIAL_KEY e execute node skills/tiktok-api/scripts/get_transcript.js <video-url>. Ele retorna o conteúdo falado como JSON por 8 créditos. Estatísticas de canal, comentários, busca por hashtag e consultas de músicas são scripts separados na mesma habilidade.
Existe uma API de mídia social gratuita?
Esta começa gratuita: 100 créditos no cadastro, sem cartão. Isso cobre aproximadamente 100 chamadas ao GitHub ou Hacker News, ou uma dúzia de transcrições do TikTok. Depois disso, os planos começam em $5/mês por 1.000 créditos.
Como dou acesso ao Claude a dados do LinkedIn?
De duas formas. Instale a habilidade linkedin-api deste repositório, ou adicione o servidor MCP hospedado com claude mcp add --transport http scrapersocial https://mcp.scrapersocial.com. Ambos cobrem perfis, empresas, busca de vagas e pessoas, posts e a biblioteca de anúncios.
O que é um servidor MCP para mídia social?
Um servidor MCP expõe ferramentas que um agente de IA pode chamar diretamente, sem você escrever código de integração. O da ScraperSocial está em https://mcp.scrapersocial.com e expõe 14 ferramentas cobrindo todas as 33 plataformas. Adicione-o uma vez e o agente pode ler dados sociais por conta própria.
Posso transcrever um reel do Instagram com uma API?
Sim — node skills/instagram-api/scripts/get_transcript.js <reel-url>, 40 créditos. Um resumo de IA do mesmo reel custa 42. Transcrições do TikTok são 8 créditos e transcrições do YouTube são 3, então verifique qual plataforma você realmente precisa.
Quanto custa?
Entre 1 e 42 créditos por chamada, dependendo do endpoint, com créditos de $3–5 por milhar. GitHub, Hacker News, Bluesky e Linktree são 1 crédito. Transcrições de vídeo e resumos de IA são o lado caro. Cada SKILL.md lista custos exatos por endpoint.
Esta é uma API oficial do TikTok, Instagram ou LinkedIn?
Não. A ScraperSocial é um produto independente, não afiliado a nenhuma plataforma mencionada aqui, e retorna apenas dados publicamente disponíveis. Onde uma plataforma oferece sua própria API — GitHub, Spotify, Reddit, Bluesky — ela costuma ser gratuita e mais rica; essas habilidades são mais úteis para as plataformas que não oferecem, e para usar uma única chave em todas elas.
As habilidades funcionam sem Node?
Elas precisam de Node 20 ou mais recente, porque usam fetch integrado. Não há outras dependências nem etapa de build. Se preferir não executar Node, use o servidor MCP hospedado.
Problemas e contribuições
Relatos de bugs e pull requests são bem-vindos em github.com/nikhonit/social-media-api-skills.
Note que skills/ e manifest.json são gerados — edite tools/content/*.md e execute node tools/generate.mjs. Veja CONTRIBUTING.md.
Para dúvidas sobre a API ou problemas com chave, envie um e-mail para support@scrapersocial.com com o request_id da resposta.
Licença
MIT No Attribution (MIT-0). Use como quiser, sem necessidade de atribuição.
Aviso Legal
ScraperSocial é um produto independente e não é afiliado, endossado ou patrocinado por qualquer plataforma mencionada neste repositório. Todos os nomes de produtos, logotipos e marcas são propriedade de seus respectivos donos. Estas habilidades retornam apenas dados publicamente disponíveis.