ScraperSocial — Social Media Data MCP Server
Perfiles públicos, publicaciones, comentarios, búsqueda y transcripciones de TikTok, Instagram, LinkedIn, YouTube, X, Reddit y 26 plataformas más como JSON limpio. 14 herramientas MCP, OAuth 2.1, servidor remoto en mcp.scrapersocial.com. 32 habilidades de agente en ClawHub, MIT-0. Nivel gratuito: 100 créditos, sin tarjeta.
Documentación
social-media-api-skills: habilidades de API de redes sociales para agentes de IA
Un kit de herramientas de API de redes sociales para agentes de IA. Estas habilidades permiten que Claude, ChatGPT, Cursor o cualquier bucle de agente personalizado lea datos públicos de 33 plataformas — la API de TikTok para transcripciones de video, la API de Instagram para reels y hashtags, la API de LinkedIn para perfiles y datos de empresas, la API de YouTube para transcripciones y comentarios, además de Reddit, X, Facebook, Amazon, Google y más — a través de una sola clave y un único envoltorio JSON. También hay un servidor MCP alojado si prefieres no instalar nada.
227 endpoints en 33 plataformas
Gratis para empezar: registrarte te da 100 créditos, sin necesidad de tarjeta. Node.js puro. Sin dependencias. Licencia MIT-0.
Instalación
La mayoría de la gente quiere la habilidad general — una habilidad que alcanza las 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
O instala una sola plataforma, cuando ya sabes cuál necesitas. Cada habilidad de plataforma está en ClawHub bajo un slug con prefijo 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 las habilidades del repositorio a la vez. Las habilidades por plataforma incluyen validación de argumentos, costos por endpoint y orientación sobre cuándo no gastar créditos; la general sacrifica eso por alcance.
Habilidades en este repositorio
| Habilidad | Plataforma | Endpoints | Qué cubre |
|---|---|---|---|
| amazon-api | Amazon | 4 | Detalle de producto, búsqueda de productos, reseñas y listados de vendedores. |
| app-store-api | App Store | 6 | Metadatos de apps, reseñas, búsqueda por palabras clave y rankings por categoría. |
| bluesky-api | Bluesky | 3 | Perfiles públicos, líneas de tiempo de publicaciones y búsqueda por palabras clave. |
| facebook-api | 23 | Transcripciones, estadísticas de páginas, comentarios, reels, anuncios, marketplace y eventos. | |
| github-api | GitHub | 11 | Repositorios, commits, contribuidores, issues, lanzamientos, perfiles y tendencias. |
| google-api | 5 | Resultados de búsqueda, información de perfiles de negocio, reseñas y anuncios de empresas. | |
| google-finance-api | Google Finance | 3 | Cotizaciones, historial de precios y búsqueda de instrumentos. |
| google-maps-api | Google Maps | 4 | Detalles de lugares, búsqueda de lugares, fotos y descubrimiento de contactos. |
| google-news-api | Google News | 1 | Búsqueda por palabras clave en titulares y fuentes de noticias. |
| google-play-api | Google Play | 4 | Metadatos de apps Android, reseñas, búsqueda por palabras clave y categorías. |
| google-shopping-api | Google Shopping | 1 | Búsqueda de productos entre comerciantes, con precios. |
| google-trends-api | Google Trends | 2 | Interés a lo largo del tiempo y consultas relacionadas en aumento. |
| hacker-news-api | Hacker News | 4 | Historias, hilos de comentarios, perfiles de usuario y búsqueda por palabras clave. |
| instagram-api | 23 | Transcripciones de reels, estadísticas de perfiles y publicaciones, comentarios, hashtags y ubicaciones. | |
| kwai-api | Kwai | 3 | Perfiles de creadores, listados de publicaciones y consultas de videos individuales. |
| linkedin-api | 38 | Perfiles y 20 sub-recursos, empresas, búsqueda de empleos y personas, publicaciones y anuncios. | |
| linkme-api | Linkme | 1 | Resolver una página de Linkme a sus enlaces y detalles de perfil. |
| linktree-api | Linktree | 1 | Resolver una página de Linktree a sus enlaces y detalles de perfil. |
| naver-api | Naver | 4 | Búsqueda de blogs, cafés, lugares y compras en el portal principal de Corea. |
| pinterest-api | 3 | Detalles de pines, búsqueda por palabras clave y conteos de guardados por URL. | |
| polymarket-api | Polymarket | 1 | Listados de mercados de predicción y probabilidades actuales. |
| reddit-api | 8 | Publicaciones, hilos de comentarios, listados de subreddits, perfiles de usuario y búsqueda. | |
| snapchat-api | Snapchat | 1 | Consultas de perfiles públicos de creadores. |
| spotify-api | Spotify | 6 | Canciones, álbumes, artistas, canciones principales, listas de reproducción y búsqueda. |
| threads-api | Threads | 5 | Perfiles, líneas de tiempo de publicaciones, estadísticas de publicaciones y búsqueda por palabras clave. |
| tiktok-api | TikTok | 16 | Transcripciones, resúmenes, estadísticas de canales, comentarios, búsqueda de hashtags y canciones. |
| tiktok-shop-api | TikTok Shop | 5 | Detalle de productos, reseñas, catálogos de tiendas y vitrinas de creadores. |
| tripadvisor-api | Tripadvisor | 2 | Búsqueda de hoteles, restaurantes y atracciones con listados de reseñas. |
| trustpilot-api | Trustpilot | 1 | Listados de reseñas de empresas. |
| truth-social-api | Truth Social | 2 | Perfiles públicos y líneas de tiempo de publicaciones de usuarios. |
| twitch-api | Twitch | 3 | Perfiles de streamers, clips y listados de videos. |
| twitter-api | X (Twitter) | 7 | Transcripciones, resúmenes de IA, estadísticas de publicaciones, perfiles, tweets y búsqueda. |
| youtube-api | YouTube | 26 | Transcripciones, subtítulos, estadísticas de videos y canales, comentarios, Shorts y búsqueda. |
| social-media-api | Todas las plataformas | 227 | Descubre y llama a cualquier endpoint documentado en todas las fuentes, sociales y web. |
Inicio 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: aún no se ha guardado ninguna muestra de salida capturada. La forma de respuesta que se muestra a continuación está tomada de la especificación OpenAPI — no es una llamada registrada. Ejecuta
SCRAPERSOCIAL_KEY=... node tools/capture.mjspara registrar salida real y regenerar.
Cada respuesta usa el mismo envoltorio:
{
"data": {},
"meta": { "count": 20, "next_cursor": "..." },
"request_id": "a18e4ef88ad4b00b"
}
data es un objeto para endpoints de entidad única y un array para los paginados. meta aparece solo en respuestas paginadas. Conserva request_id — es como el soporte rastrea una llamada.
Los errores siguen la misma disciplina:
{
"error": {
"code": "invalid_url",
"message": "...",
"hint": "...",
"request_id": "..."
}
}
Las llamadas fallidas no se cobran.
Funciona con
Estos son scripts Node simples con un contrato documentado, así que cualquier cosa que pueda ejecutar un comando puede usarlos.
- Claude Code / Claude Skills — instala con
npx skills add nikhonit/social-media-api-skills - ChatGPT — expón un script como función o ejecútalo en un paso de intérprete de código
- Cursor, Cline, Windsurf — coloca el repositorio y deja que el agente lea
SKILL.md - Cualquier bucle de agente — llama a los scripts como subprocesos y analiza stdout
Instalación cero: el servidor MCP alojado
Si prefieres no incluir nada, ScraperSocial ejecuta un servidor MCP alojado que alcanza los mismos endpoints:
Claude.ai: Configuración → Conectores → Añadir conector personalizado → https://mcp.scrapersocial.com (OAuth, sin clave que pegar). Instrucciones completas por cliente, incluyendo Windsurf, Gemini CLI y ChatGPT, están en 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_..." }
}
}
}
Expone 14 herramientas — doce herramientas de capacidad (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) más list_endpoints y call_endpoint, que entre ellas alcanzan toda la superficie. La autenticación es OAuth 2.1 PKCE o una clave bearer.
Usa las habilidades de este repositorio cuando quieras orientación por plataforma, validación de argumentos y control sobre exactamente qué endpoint se ejecuta. Usa el servidor MCP cuando quieras no instalar nada.
Lo que obtienes
- JSON limpio, un envoltorio para cada plataforma
request_iden cada respuesta, incluyendo errores- Cabecera
x-cache: hit|missque te dice si vino de caché - Control de proyección y formato —
fieldsrecorta la respuesta,formatcambia entrejson,csvyndjson - OpenAPI 3.1: scrapersocial.com/openapi.json
- Resumen legible por agentes: llms.txt · llms-full.txt
Cada endpoint es GET https://api.scrapersocial.com/v1/{platform}/{capability}. Parámetros opcionales en cada llamada:
| Parámetro | Efecto |
|---|---|
limit | Elementos en endpoints paginados. Por defecto 20. Los scripts limitan esto a 50 — por encima de eso la API devuelve un trabajo asíncrono en lugar de datos. |
cursor | next_cursor del meta de una respuesta anterior. |
fields | Proyección, p. ej. fields=id,author.name. |
format | json (por defecto), csv, ndjson. |
fresh | true omite la caché al mismo costo de créditos. |
Autenticación
Cada script lee una variable de entorno:
export SCRAPERSOCIAL_KEY=sk_live_...
Gestiona las claves en scrapersocial.com/app/keys. Los scripts nunca imprimen tu clave — la salida de error lleva el request_id en su lugar. Mantenla fuera del control de versiones.
Precios
| Plan | Precio | Créditos | Límite de velocidad |
|---|---|---|---|
| Gratis | $0 | 100 únicos al registrarte, sin tarjeta | 20/min |
| Mensual | $5/mes | 1,000/mes, recargas $4/1k | 200/min |
| Anual | $54/año | 12,000 por adelantado, recargas $3/1k | 300/min |
| Empresa | personalizado | personalizado | 1,500/min |
Los créditos se cobran por elemento devuelto en endpoints paginados y por llamada en el resto. Los costos van desde 1 crédito (GitHub, Hacker News, Bluesky, Linktree) hasta 42 (resumen de IA de Instagram). El SKILL.md de cada habilidad lista el costo exacto de cada endpoint que envuelve. Los aciertos de caché cuestan lo mismo que las llamadas frescas y se devuelven en milisegundos. Las llamadas fallidas no se cobran.
Preguntas frecuentes
¿Cómo obtengo datos de TikTok como JSON?
Instala tiktok-api, exporta SCRAPERSOCIAL_KEY y ejecuta node skills/tiktok-api/scripts/get_transcript.js <video-url>. Devuelve el contenido hablado como JSON por 8 créditos. Las estadísticas de canal, comentarios, búsqueda de hashtags y consultas de canciones son scripts separados en la misma habilidad.
¿Hay una API de redes sociales gratuita?
Esta comienza gratis: 100 créditos al registrarte sin tarjeta. Eso cubre aproximadamente 100 llamadas a GitHub o Hacker News, o una docena de transcripciones de TikTok. Después, los planes comienzan en $5/mes por 1,000 créditos.
¿Cómo le doy a Claude acceso a datos de LinkedIn?
Dos formas. Instala la habilidad linkedin-api de este repositorio, o añade el servidor MCP alojado con claude mcp add --transport http scrapersocial https://mcp.scrapersocial.com. Ambos cubren perfiles, empresas, búsqueda de empleos y personas, publicaciones y la biblioteca de anuncios.
¿Qué es un servidor MCP para redes sociales?
Un servidor MCP expone herramientas que un agente de IA puede llamar directamente, sin que escribas código de conexión. El de ScraperSocial está en https://mcp.scrapersocial.com y expone 14 herramientas que cubren las 33 plataformas. Añádelo una vez y el agente puede leer datos sociales por sí solo.
¿Puedo transcribir un reel de Instagram con una API?
Sí — node skills/instagram-api/scripts/get_transcript.js <reel-url>, 40 créditos. Un resumen de IA del mismo reel cuesta 42. Las transcripciones de TikTok son 8 créditos y las de YouTube son 3, así que verifica qué plataforma necesitas realmente.
¿Cuánto cuesta?
Entre 1 y 42 créditos por llamada dependiendo del endpoint, con créditos desde $3–5 por millar. GitHub, Hacker News, Bluesky y Linktree son 1 crédito. Las transcripciones de video y los resúmenes de IA son el extremo caro. Cada SKILL.md lista los costos exactos por endpoint.
¿Es esta una API oficial de TikTok, Instagram o LinkedIn?
No. ScraperSocial es un producto independiente, no afiliado con ninguna plataforma mencionada aquí, y devuelve solo datos disponibles públicamente. Donde una plataforma ofrece su propia API — GitHub, Spotify, Reddit, Bluesky — esa suele ser gratuita y más rica; estas habilidades son más útiles para las plataformas que no la ofrecen, y para usar una sola clave en todas ellas.
¿Las habilidades funcionan sin Node?
Necesitan Node 20 o más reciente, porque usan fetch integrado. No hay otras dependencias ni paso de compilación. Si prefieres no ejecutar Node en absoluto, usa el servidor MCP alojado.
Problemas y contribuciones
Los informes de errores y las solicitudes de extracción son bienvenidos en github.com/nikhonit/social-media-api-skills.
Note que skills/ y manifest.json son generados — edite tools/content/*.md y ejecute node tools/generate.mjs. Consulte CONTRIBUTING.md.
Para preguntas sobre la API o problemas con claves, envíe un correo a support@scrapersocial.com con el request_id de la respuesta.
Licencia
MIT Sin Atribución (MIT-0). Úselos como desee, sin necesidad de atribución.
Aviso legal
ScraperSocial es un producto independiente y no está afiliado, respaldado ni patrocinado por ninguna plataforma mencionada en este repositorio. Todos los nombres de productos, logotipos y marcas son propiedad de sus respectivos dueños. Estas habilidades devuelven únicamente datos disponibles públicamente.