Socialcrawl MCP
Una sola clave API para acceder a datos de redes sociales en tiempo real de más de 21 fuentes.
Documentación
socialcrawl-mcp
Dale a tu agente de IA acceso a 65 plataformas y 575 endpoints — redes sociales, comercio, marketplaces y reseñas de productos, retail, tiendas de aplicaciones, lugares, viajes y local, reputación empresarial y de software, empleos y salarios, mercados y finanzas, divulgaciones de operaciones del Congreso, noticias, investigación web, scraping web completo y automatización de navegador, SEO en página, mercados de predicción, tendencias de búsqueda, composites Prism multiplataforma y una meta-búsqueda universal — a través de una sola API, con precios exactos en créditos para cada endpoint
Overview | Instalación | Configuración | Uso | Herramientas | Plataformas
Overview
socialcrawl-mcp es un servidor MCP (Model Context Protocol) que conecta agentes de IA a la API de SocialCrawl — una API de datos unificada que cubre 65 plataformas y 575 endpoints.
Recupera perfiles, publicaciones, comentarios, resultados de búsqueda, contenido en tendencia y analíticas de TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Reddit, Threads, Douyin, Telegram, Quora, Apple Music, GitHub, Hacker News, Polymarket y más de 30 plataformas adicionales. Obtén productos, ofertas, historial de precios, reseñas y vendedores de Amazon, Walmart, Target, Home Depot, eBay, Klarna, AliExpress, Etsy, Sephora, H&M, Kohl's, Wayfair, Gumtree y Google Shopping; aplicaciones, listas y reseñas de Google Play y la App Store de Apple; hoteles, restaurantes, atracciones, cruceros y reseñas de viajeros de Tripadvisor, además de datos de negocios locales de Yelp y Google Business; reputación de marca de Trustpilot y reseñas de software de G2; listados de empleo y rangos salariales de LinkedIn, Indeed, Bing y Xing; cotizaciones de mercado, historial de precios, estados financieros y cadenas de opciones; divulgaciones de operaciones del Congreso de EE. UU.; series de tendencias de búsqueda y Data Lab de Naver en coreano; menciones de marca en toda la web con sentimiento mediante Content Analysis; titulares de Google News y curvas de interés de Google Trends — además de investigación web mediante Tavily y Perplexity, búsqueda en X impulsada por IA mediante Grok, auditorías de SEO en página y un único endpoint /search/everywhere que se distribuye entre 14 fuentes en una sola llamada.
Novedades en esta versión (v1.12.0): una re-sincronización del registro que añade tres endpoints y dos nuevas palancas de precio.
- Los propios rankings de TikTok.
tiktok/hashtags/popularlee el tablero de hashtags en tendencia para un mercado y una ventana de tiempo — el tablero general más 15 tableros de industria, 2cr por hashtag devuelto (un tablero cuesta 6cr;industry=allcontiene 96 y se estabiliza alrededor de 88-92).tiktok/videos/popularlee el tablero de Top Videos para EE. UU., Japón, Vietnam, Tailandia o Indonesia a 25cr por tablero más 1cr por video. Ambos son rankings clasificados sin segunda página. google_trends/trending— Trending Now por ubicación, con filtros de ventana de hora, categoría, estado y ordenación (5cr).coverage=fulleninstagram/followersyinstagram/following. Un recorrido combinado que nunca repite una cuenta entre páginas hasta que las filas alcanzan el total propio del perfil. Duplica el precio de página a 10cr, lo que movió ambos endpoints de una tarifa plana escalonada a una banda medida de 5-10cr — y una lista completa es genuinamente costosa (una lista de seguidos de 2,652 cuentas tomó 54 páginas, 540 créditos, medido el 13/09).socialcrawl_pricingcotiza la banda y nombra acoveragecomo la palanca.feed=global|localentiktok/trending— el feed web mundial, o el feed For You tal como lo vería un teléfono enregion(más contenido del país, más lento, más videos).instagram/location/postsahora pagina correctamente con un cursor en lugar de ser una cuadrícula única de 60 publicaciones.
Los precios, parámetros, formas de respuesta y descriptores de paginación están re-sincronizados en otros 24 endpoints. La hidratación de filas (las uniones opcionales include= añadidas en v1.11.0) no cambia: 33 uniones en 28 endpoints.
Qué hace el servidor MCP:
- Descubre plataformas y endpoints dinámicamente, o mediante búsqueda de texto libre en los 575
- Obtiene datos en vivo en tu nombre en cada plataforma, método y composite
- Cotiza cada llamada por adelantado — escalonado, plano o banda medida — para que un agente pueda presupuestar antes de gastar
- Valida solicitudes localmente antes de llamar a la API: parámetros requeridos, grupos
oneOf, valores de enumeración, rangos enteros, acoplamientos de parámetros y límites CSV. Una llamada incorrecta falla gratis en lugar de quemar créditos - Proporciona documentación de API integrada que el agente puede consultar bajo demanda, paginada en lugar de truncada
Instalación
Servidor remoto (alojado — sin instalación)
Conéctate directamente al endpoint HTTP Streamable alojado — nada que instalar o ejecutar:
Claude Code (funciona en la CLI y en Claude Code en la web / sandboxes en la nube)
claude mcp add --scope user --transport http socialcrawl https://mcp.socialcrawl.dev/mcp \
--header "Authorization: Bearer sc_your_key_here"
Cualquier cliente que lea .mcp.json
{
"mcpServers": {
"socialcrawl": {
"type": "http",
"url": "https://mcp.socialcrawl.dev/mcp",
"headers": { "Authorization": "Bearer ${SOCIALCRAWL_API_KEY}" }
}
}
}
Cursor / Windsurf / VS Code — elige el tipo de servidor HTTP ("streamable-http") con la misma URL y cabecera. x-api-key: sc_your_key_here funciona como cabecera alternativa.
Las herramientas de descubrimiento (socialcrawl_list_platforms, socialcrawl_list_endpoints, socialcrawl_get_docs) funcionan sin clave, para que puedas explorar antes de registrarte. Los conectores personalizados de claude.ai (Configuración → Conectores) requieren OAuth, que llegará en una versión posterior — usa la configuración basada en cabecera anterior mientras tanto.
¿Prefieres ejecutarlo localmente? Cada opción stdio a continuación funciona exactamente como antes.
npm
npm install -g socialcrawl-mcp
Disponible en npm. La mayoría de los usuarios no lo necesitan — las configuraciones de cliente MCP a continuación usan npx y se autoinstalan en la primera ejecución.
Claude Code (lo más rápido)
claude mcp add --scope user socialcrawl -- npx -y socialcrawl-mcp
Luego establece tu clave de API:
claude mcp add-env socialcrawl SOCIALCRAWL_API_KEY sc_your_key_here
Claude Desktop
Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"socialcrawl": {
"command": "npx",
"args": ["-y", "socialcrawl-mcp"],
"env": {
"SOCIALCRAWL_API_KEY": "sc_your_key_here"
}
}
}
}
Cursor
Añade a .cursor/mcp.json en la raíz de tu proyecto o ~/.cursor/mcp.json globalmente:
{
"mcpServers": {
"socialcrawl": {
"command": "npx",
"args": ["-y", "socialcrawl-mcp"],
"env": {
"SOCIALCRAWL_API_KEY": "sc_your_key_here"
}
}
}
}
VS Code (Claude Code)
Añade a .vscode/mcp.json en tu proyecto o en la configuración de usuario:
{
"servers": {
"socialcrawl": {
"type": "stdio",
"command": "npx",
"args": ["-y", "socialcrawl-mcp"],
"env": {
"SOCIALCRAWL_API_KEY": "sc_your_key_here"
}
}
}
}
Windsurf
Añade a tu configuración MCP de Windsurf:
{
"mcpServers": {
"socialcrawl": {
"command": "npx",
"args": ["-y", "socialcrawl-mcp"],
"env": {
"SOCIALCRAWL_API_KEY": "sc_your_key_here"
}
}
}
}
Otros clientes compatibles con MCP
Cualquier cliente MCP que admita transporte stdio puede usar este servidor. El patrón general es:
- Comando:
npx - Argumentos:
["-y", "socialcrawl-mcp"] - Entorno:
SOCIALCRAWL_API_KEYconfigurado con tu clave de API
Reinicia tu cliente de IA después de guardar la configuración.
Configuración
1. Obtén tu clave de API
Regístrate en socialcrawl.dev y toma tu clave de API del panel. Cada cuenta comienza con 100 créditos gratis — no se requiere tarjeta de crédito.
2. Añade la clave a tu configuración
Reemplaza sc_your_key_here en la configuración de instalación anterior con tu clave de API real (comienza con sc_).
[!TIP] También puedes configurar
SOCIALCRAWL_API_KEYcomo variable de entorno del sistema en lugar de ponerla en la configuración MCP. Las herramientas de descubrimiento y documentación funcionan incluso sin clave — solo las solicitudes reales a la API la necesitan.
Uso
Pregunta a tu agente de IA en lenguaje natural. El servidor MCP se encarga del resto.
Obtener un perfil
Get the TikTok profile for @charlidamelio
El agente llama a socialcrawl_request con platform: "tiktok", resource: "profile", params: { handle: "charlidamelio" } y devuelve datos estructurados del perfil, incluidos seguidores, biografía, estado de verificación y métricas de participación.
Buscar en todas las plataformas
Search YouTube for "machine learning tutorials"
Obtener comentarios de una publicación
Get the comments on this Instagram post: https://instagram.com/p/CwA1234abcd
Investigación multiplataforma
Compare the follower counts of @mkbhd on TikTok, Instagram, YouTube, and Twitter
El agente realiza 4 llamadas secuenciales a la API — una por plataforma — y compila los resultados en una comparación.
Comprar en varios minoristas
Find the cheapest 65-inch OLED TV across Amazon, Walmart, Target, and eBay
Explorar endpoints disponibles
What social media platforms can you access?
Show me all the TikTok endpoints
Which endpoints can give me video transcripts?
La última es una búsqueda socialcrawl_list_endpoints multiplataforma — no se necesita plataforma, busca en los 575 endpoints.
Aprende la API desde la API
How do I get started with SocialCrawl?
Show me exactly how to call the Prism comments endpoint
Is this MCP server's endpoint list up to date?
Las tres usan socialcrawl_discover y no cuestan nada.
Comprueba cuánto cuesta algo antes de ejecutarlo
What would it cost to run a Prism brand-mentions report?
Show me everything I can call for 1 credit
Why did that last call charge me 7 credits instead of 2?
Las dos primeras usan socialcrawl_pricing; la tercera lee el libro de créditos mediante socialcrawl_check_balance con view: "transactions" y muestra las filas de deducción y reembolso para ese request_id.
Acceder a la documentación
How does the SocialCrawl credit system work?
How do I page through a list endpoint?
Ejemplo de respuesta
Cada respuesta sigue un formato de sobre unificado:
{
"success": true,
"platform": "tiktok",
"endpoint": "/v1/tiktok/profile",
"data": {
"content": { "text": "...", "media_urls": ["..."] },
"author": { "username": "charlidamelio", "followers": 156000000 },
"engagement": { "likes": 5200, "engagement_rate": 0.045 },
"metadata": { "language": "en", "content_category": "entertainment" }
},
"credits_used": 1,
"credits_remaining": 99
}
[!NOTE] La misma estructura de respuesta se devuelve para cada plataforma — no se necesita lógica de análisis por plataforma.
Herramientas disponibles
El servidor MCP expone 10 herramientas:
| Herramienta | Descripción | ¿Necesita clave de API? |
|---|---|---|
socialcrawl_list_platforms | Descubre las 65 plataformas, agrupadas por categoría, con recuentos de endpoints y rangos de crédito por plataforma | No |
socialcrawl_list_endpoints | Endpoints con su contrato completo de parámetros — tipos, rangos enteros, valores de enumeración, acoplamientos de parámetros, límites CSV, estilo de paginación, TTL de caché y precios. Pasa un platform, o un término search para encontrar un endpoint entre los 575. Filtra por method y maxCost | No |
socialcrawl_pricing | Coste exacto en créditos para cada endpoint: la escalera de niveles, cada anulación plana, todas las bandas medidas con sus reglas de cobro y parámetros que afectan el precio, tablas de costes por plataforma, rankings filtrados por presupuesto (maxCost, model, sort), el catálogo completo de uniones de filas include=, y una cotización exacta por adelantado para una llamada que describas | No |
socialcrawl_request | Realiza cualquier llamada a la API de SocialCrawl — perfiles, publicaciones, comentarios, búsqueda, tendencias, analíticas, composites Prism. Los endpoints GET aceptan params de consulta; los endpoints POST por lotes (p. ej. youtube/videos, prism/profiles) aceptan su body de array/objeto. Admite un idempotencyKey opcional para llamadas seguras contra reintentos | Sí |
socialcrawl_check_balance | Saldo de créditos y deducciones recientes, o el libro detallado (view: "transactions") — cada deducción y reembolso claveado por request_id. Llama a /v1/credits/{balance,transactions} — cuesta 0 créditos | Sí |
socialcrawl_monitors | Crea y gestiona monitores con estado que re-ejecutan cualquier receta en una cadencia, entregan resultados a un webhook firmado y acumulan una serie temporal. Acciones: create, list, get, runs, timeseries, pause, resume, delete | Sí |
socialcrawl_web | Scraping web completo y automatización de navegador (la plataforma web). Sincrónico scrape/search/map/extract; asíncrono crawl/batch_scrape/agent jobs con poll/cancel/errors; vista previa gratuita de parámetros de crawl; monitores con estado; sesiones de navegador interactivas. Un action por endpoint | Sí |
socialcrawl_cohorts | Búsqueda de menciones filtrada por audiencia (/v1/cohorts/*) — sube hasta 10,000 identidades públicas que ya te importan, luego pregunta cuáles de ellos publicaron tus palabras clave. Acciones: create, add_members, estimate_cost (local, gratis), query, query_status, query_results, query_cancel, get, delete. Todo excepto la consulta cuesta 0 créditos | Sí |
socialcrawl_discover | La API describiéndose a sí misma, en vivo, a 0 créditos (/v1/utility/*) — inicio rápido, el catálogo completo de endpoints con precios en vivo conscientes de bandas medidas, la guía de uso completa de un endpoint, el corpus de contexto del agente, una verificación de frescura que te dice si el catálogo incluido de este servidor se ha quedado atrás de la API, y el status de cortacircuitos en vivo de cada plataforma | Opcional |
socialcrawl_get_docs | Documentación de API por tema o plataforma — overview, authentication, credits, pricing, errors, idempotency, pagination, caching, response-schema, limits, monitors, cohorts, discovery, o cualquier slug de plataforma. Los temas largos se paginan, nunca se truncan | No |
Cuatro de las diez herramientas funcionan sin clave de API: consultan datos locales incluidos generados a partir del registro del backend. socialcrawl_request, socialcrawl_check_balance, socialcrawl_monitors, socialcrawl_web y socialcrawl_cohorts requieren una clave. socialcrawl_discover usa una clave cuando la tiene y recurre a los datos incluidos cuando no la tiene (su acción status no necesita clave en absoluto). |
Descubrimiento: la API que se describe a sí misma, gratis
socialcrawl_discover impulsa la familia /v1/utility/*: cuatro endpoints que permiten a cualquier cliente conocer toda la API desde dentro de la propia API, a 0 créditos. Se sirven en proceso desde el registro de endpoints, sin llamada ascendente ni salto de red, por lo que nunca pueden desviarse de lo que realmente se puede invocar.
| Acción | Endpoint | Qué obtienes |
|---|---|---|
quickstart | /v1/utility/quickstart | Autenticación, URL base, una primera llamada ejecutable, los sobres de éxito y error, el modelo de facturación, la taxonomía completa de errores, los límites de tasa y el contrato de paginación, en una sola respuesta |
catalog | /v1/utility/endpoints | Cada endpoint con su etiqueta de precio en vivo según medición, parámetros obligatorios y opcionales, grupos oneOf y marcador de paginación. Filtra por platform / search / method |
endpoint | /v1/utility/endpoint | La guía de uso completa de un endpoint: cada parámetro con tipo y ejemplo, la regla de precios exacta, TTL de caché, receta de paginación, una respuesta de ejemplo, un curl de copiar y pegar, y endpoints relacionados |
llms | /v1/utility/llms | El corpus de contexto para agente de toda la API o de una plataforma, en markdown o JSON: inicia un agente en una sola llamada en lugar de rastrear documentación |
freshness | — | Compara el registro en vivo con el catálogo incluido de este servidor |
Por qué freshness importa. Este servidor incluye un catálogo generado cuando se compiló; la API sigue moviéndose. Las llamadas de datos siempre llegan a la API en vivo y siguen funcionando, pero el descubrimiento, los precios y la validación local responden desde esa instantánea, por lo que un endpoint recién añadido parece desconocido hasta que actualizas. Una llamada gratuita te dice en qué situación te encuentras:
socialcrawl_discover action: "freshness"
Incluido vs. en vivo. list_platforms, list_endpoints, pricing y get_docs responden al instante desde datos incluidos y no necesitan clave: prefíerelos para explorar. Recurre a socialcrawl_discover cuando la corrección importe más que la latencia: un endpoint parece faltar, necesitas el precio en vivo exacto de un endpoint medido o estás generando código que debe coincidir con producción hoy. Sin clave, igualmente responde todo excepto llms desde datos incluidos, así que el descubrimiento nunca exige autenticación de forma estricta.
Estos mismos endpoints son HTTP plano, por lo que una integración de terceros o un framework de agentes no MCP obtiene la información idéntica con un curl.
Precios: conoce el costo antes de gastar
socialcrawl_pricing existe porque un solo número es una mentira para la mayor parte de la superficie. SocialCrawl factura de tres maneras:
- Escalera (443 endpoints): la tarifa por nivel por solicitud: estándar 1cr, avanzado 5cr, premium 10cr.
- Plana (61 endpoints, 18 de ellos gratuitos): una anulación por endpoint, p. ej.,
/v1/search/everywherea 20cr planos. - Medida (71 endpoints): el cargo depende de la solicitud. Se deduce un tope inicial y se reembolsa hasta el trabajo realmente realizado.
Cotizar el costo base de un endpoint medido subestima cada llamada: /v1/search/news tiene una base de 1cr pero realmente cobra 2–62cr: un crédito por cada tramo de país de Google que devuelva artículos, más facturación por artículo cuando se añade el motor de bing. La herramienta devuelve la banda real, la regla de cobro propia del registro, los parámetros que mueven la factura y el peor caso para presupuestar:
action: "overview" → ladder, every free endpoint, every flat override, every metered band + rule, cache TTLs, full refund matrix
action: "endpoint" → one endpoint's price, rule, price-driving params, paging cost, worst case
action: "platform" → a whole platform's cost table
action: "list" → rank/filter by cost — "everything I can call for 1 credit", "the 10 most expensive endpoints"
action: "hydration" → every include= row join: what it fills, per-row rate, row cap, fully-joined ceiling
Pasa el include que piensas enviar a action: "endpoint" y la banda se convierte en aritmética: la retención exacta, detallada por unión, usando la misma fórmula que ejecuta el pricer del backend:
action: "endpoint", platform: "linkedin", resource: "search/people", include: "profile", rows: 3
→ holds 22 credits (10cr page + 12cr for 3 rows of `profile`), settling anywhere down to 10
También indica las reglas que hacen que el cargo real difiera del precio de etiqueta: aciertos de caché, reproducciones idempotentes, resultados vacíos y fallos ascendentes son todos 0 créditos.
Hidratación de filas: una llamada en lugar de una página más una consulta por fila
Algunas listas son delgadas porque el upstream no publica nada más sobre ellas: un resultado de búsqueda de Pinterest no tiene recuento de guardados, una fila de reacciones de LinkedIn no tiene recuento de seguidores, una lista de reproducción de YouTube no tiene vistas ni duraciones. Otro endpoint de SocialCrawl responde cada uno de esos datos para una fila, así que 28 endpoints ahora aceptan un token include= que une cada fila con ese endpoint hermano en la misma llamada.
GET /v1/pinterest/search?query=kitchen&include=engagement → saves, likes, comments, shares on every row
GET /v1/youtube/playlist?playlistId=PL...&include=engagement,channel
GET /v1/linkedin/search/people?keywords=cto&include=profile&limit=3
- Opt-in. Sin token, sin unión, sin crédito extra, sin latencia extra: quien nunca lo pide paga exactamente lo que siempre pagó.
- Facturado por fila realmente completada. El tope se retiene por adelantado; solo se conserva un crédito por una fila que una búsqueda hermana nueva completó. Las filas servidas desde la caché del hermano son gratuitas, las filas no completables se reembolsan, y una página que se unió por completo se guarda en caché entera, así que una repetición inmediata es 0 créditos.
- Un tope de filas limita la factura.
limit=3&include=profileen LinkedIn retiene 22 créditos, no 50. - Te dice lo que hizo.
data.hydrationinforma filas, búsquedas, aciertos de caché, créditos retenidos vs. conservados y milisegundos;_warningslleva<token>_partialcuando solo se completaron algunas filas.
socialcrawl_pricing con action: "hydration" lista cada unión y su precio; socialcrawl_list_endpoints con hydrating: true encuentra los endpoints que ofrecen una; el tema socialcrawl_get_docs hydration es el contrato completo.
Monitores: programa cualquier receta
socialcrawl_monitors envuelve cualquier endpoint del registro o compuesto de Prism en un monitor programado y con estado (/v1/monitors/*). Vuelve a ejecutar la receta cada hora/día/semana (o en un cron), entrega cada resultado a un webhook firmado con HMAC, genera alertas sobre umbrales o cambios de métricas y mantiene una serie temporal por ejecución que puedes leer. "Prism responde una vez; los monitores lo vigilan por ti." Gestionar monitores cuesta 0 créditos; cada ejecución programada factura el costo normal de la receta más una prima de programación de 1 crédito. Consulta el tema socialcrawl_get_docs monitors para el contrato completo.
Web: scrape, crawl, navega
socialcrawl_web impulsa toda la superficie de scraping web y automatización de navegador (la plataforma web, /v1/web/*) a través de un único parámetro action:
- Lecturas síncronas —
scrape(URL → markdown/HTML/captura/enlaces),search(búsqueda web con contenido de página),map(descubre las URLs de un sitio),extract(datos estructurados LLM desde una página). - Trabajos asíncronos —
crawlun sitio completo,batch_scrapemuchas URLs oagent(tarea web autónoma de varios pasos); cada uno devuelve un trabajo que consultas conjob_get/job_list, inspeccionas conjob_errors(fallos por página) y detienes conjob_cancel.crawl_previewprueba en seco los parámetros de un crawl gratis antes de pagar por él. - Monitores —
monitor_create/list/get/update/delete/checksvuelven a comprobar una URL en una cadencia y entregan cambios a un webhook. - Sesiones —
session_create/get/list,session_execute(ejecuta código en la página en vivo),session_close.
La mayor parte de la superficie web de pago es medida en lugar de plana: un crawl retiene limit créditos y reembolsa cada página que no rastreó; una sesión retiene contra ttl_seconds y se liquida al cerrar. La gestión de trabajos, monitores y sesiones es 0 créditos. Consulta el tema socialcrawl_get_docs web, o socialcrawl_pricing con platform: "web".
Validación inteligente
Antes de hacer cualquier llamada a la API, socialcrawl_request replica el validador previo a facturación del backend contra los datos del registro incluido: la plataforma y el recurso existen, los parámetros obligatorios y los grupos oneOf se cumplen, los valores de enum son legales, los enteros están dentro de su rango declarado, los acoplamientos de parámetros se mantienen (order necesita sort; el timeframe de Reddit necesita sort=top) y las listas CSV están dentro de sus límites de entradas. Una llamada malformada falla al instante y gratis en lugar de costar un viaje de ida y vuelta, y un agente recibe exactamente qué corregir en lugar de repetir una llamada que nunca puede tener éxito.
Solicitudes seguras ante reintentos
Pasa un idempotencyKey a socialcrawl_request (se recomienda UUIDv4) para que la llamada sea segura ante reintentos. Si la solicitud se reproduce dentro de 24 horas, el servidor devuelve la respuesta original y deduce 0 créditos (X-Idempotent-Replay: true).
Plataformas compatibles
| Plataforma | Endpoints | Datos disponibles |
|---|---|---|
| 45 | Perfiles y páginas de empresa, publicaciones, republicaciones, reacciones, comentarios y respuestas, búsqueda de personas/empresas, sub-recursos de perfil (experiencia, educación, habilidades, certificaciones…), el archivo completo del historial de publicaciones (medido por publicación), empleos (búsqueda, empleos de empresa, detalles), información de empresas, grupos, transcripciones, Biblioteca de Anuncios, perfil-360 | |
| 37 | Perfiles, transparencia de cuenta (perfil/acerca de), publicaciones, reels, comentarios y respuestas a comentarios, destacados, historias, feeds etiquetados y de ubicación, seguidores/siguiendo, cuentas similares, personas que dan "me gusta" a publicaciones, estadísticas de compartidos, feeds de reels/publicaciones con conteo de compartidos en una sola llamada, análisis de interacción, búsqueda universal y de publicaciones populares, búsqueda de reels/hashtags/perfiles/ubicaciones/música, tendencias, transcripciones, perfil-360 | |
| TikTok | 36 | Perfiles, videos, comentarios y respuestas, extracción de texto en pantalla, búsqueda por palabra clave/hashtag/usuario/música + sugerencias, detalles de hashtags, tendencias (global o "Para ti" por país), tableros propios de hashtags populares y videos destacados de TikTok, audiencia, seguidores, videos con "me gusta", listas de reproducción y colecciones, feeds de lugares, efectos, en vivo, canciones, transcripciones, Biblioteca de Anuncios, perfil-360 |
| Prism | 33 | Compuestos multiplataforma: búsqueda por URL, recolección de comentarios, búsqueda por lotes de comentarios/perfiles, auditoría de handles, menciones de marca, señales de demanda, visibilidad de IA, radar de crisis/análisis post-mortem, reputación, participación de voz, verificación de creadores y tarjetas de creador, radar de organizaciones, brecha de Corea, respuestas de consenso de IA, inteligencia de video/aplicaciones/productos |
| YouTube | 29 | Canales, videos, cortos, comentarios y respuestas, patrocinadores, listas de reproducción y elementos, publicaciones de la comunidad, búsqueda (avanzada + autocompletado), tendencias, transmisiones en vivo, búsqueda de correo de contacto del canal, archivos multimedia (audio/video/subtítulos/miniaturas), transcripciones, videos/canales/transcripciones por lotes, perfil-360 |
| 24 | Páginas, grupos y publicaciones de grupos, publicaciones, comentarios, fotos, reels (incluido el feed completo de reels con conteo de vistas), eventos, Marketplace, transcripciones, Biblioteca de Anuncios completa | |
| Web Scraping | 22 | Raspado, búsqueda web, mapa del sitio, extracción con LLM, rastreo asíncrono/raspado por lotes/trabajos de agente con feeds de errores por página, monitores de cambios, sesiones de navegador interactivas, análisis de documentos — impulsado por socialcrawl_web |
| Operaciones del Congreso de EE. UU. | 19 | Divulgaciones de la Ley STOCK del Congreso de EE. UU.: feeds de operaciones (todas/48h/7d), miembros, estadísticas y operaciones por político y por ticker, delegaciones estatales y el conjunto completo de estadísticas (partido, sectores, emisores, volumen, actividad inusual, ratio compra/venta, presentaciones tardías) |
| Klarna | 18 | Detalles de productos y cada oferta de comerciante, búsqueda por palabra clave + sugerencias, reseñas de usuarios y profesionales con resúmenes de puntuación, historial de precios, comparación de productos, navegación por categorías con filtros/palabras clave/guias de compra, listados de tiendas |
| Tripadvisor | 16 | Hoteles, restaurantes, atracciones y cruceros: búsqueda y detalle completo de cada uno, reseñas de viajeros con respuestas del propietario, búsqueda de lugar por URL, autocompletado de destinos, tipos de experiencias |
| Twitter/X | 15 | Perfiles, tweets y respuestas, búsqueda de tweets y usuarios, medios de usuario, seguidores, siguiendo, retweeters, comunidades, transcripciones de video, búsqueda de IA vía Grok, perfil-360 |
| Naver | 14 | El portal n.º 1 de Corea: blog, noticias, enciclopedia, café, KiN, local, imágenes, búsqueda web, clasificadores de erratas y adultos, series de tendencias de búsqueda de Data Lab y de información de compras, resumen |
| 14 | Subreddits, detalle de publicaciones, comentarios, perfiles de usuario con historial de publicaciones y comentarios, búsqueda por palabra clave/comentario/medio, descubrimiento de subreddits, transcripciones, barrido de voz del cliente omni-búsqueda | |
| GitHub | 12 | Usuarios, repos, issues, PRs, READMEs, lanzamientos, búsqueda, dossier de repos, velocidad de perfil de usuario |
| Gumtree | 11 | Clasificados del Reino Unido: búsqueda y detalles de anuncios, anuncios similares, perfiles de vendedores y sus anuncios, sugerencias de búsqueda, búsquedas en tendencia, árbol de categorías con filtros, búsqueda de ubicación |
| Empleos | 11 | Búsqueda de empleo y detalle de anuncios en LinkedIn, Indeed, Bing y Xing, resolución de ID de organización de LinkedIn y rangos salariales por título y país |
| Sephora | 11 | Detalles de productos, reseñas, búsqueda por palabra clave + sugerencias, navegación por árbol de categorías, listados de marcas y productos por marca, búsqueda de tiendas, disponibilidad en tienda por SKU |
| Análisis de Contenido | 10 | Menciones de marca en toda la web, sentimiento, distribuciones de calificaciones, tendencias de frases/categorías |
| 10 | Búsqueda web, Transparencia de Anuncios, Perfil de Negocio (información, reseñas, actualizaciones, preguntas y respuestas), hoteles de Travel | |
| AliExpress | 9 | Detalles de productos, búsqueda por palabra clave, productos similares, reseñas, envío por SKU, productos populares, promociones destacadas, árbol de categorías |
| Apple App Store | 9 | Búsqueda de aplicaciones, sugerencias de búsqueda, detalles de aplicaciones, reseñas, listados, base de datos de listados, datos de referencia |
| Google Play | 9 | Búsqueda de aplicaciones, sugerencias de búsqueda, detalles de aplicaciones, reseñas, listados, base de datos de listados, datos de referencia |
| Amazon | 8 | Búsqueda de productos, detalles de ASIN, reseñas, vendedores, páginas de tienda, listados de Más Vendidos, ofertas actuales, perfiles de vendedores — ~13 mercados |
| Douyin | 8 | El TikTok de China: búsqueda de videos, perfiles y feeds de creadores, detalle de videos, comentarios y respuestas a comentarios, búsqueda de creadores, tablero de búsquedas populares (mayormente medido por fila) |
| Finanzas | 7 | Cotizaciones de instrumentos, búsqueda de tickers, resumen de mercados, noticias de instrumentos, historial diario de precios, estados financieros de empresas, cadenas de opciones |
| G2 | 7 | Mercado de software: páginas de productos, reseñas, listados de categorías e índice de categorías, perfiles de vendedores y su catálogo, índice de URL de productos |
| Quora | 7 | Búsqueda y detalle de preguntas, búsqueda de respuestas, búsqueda de publicaciones de Space, búsqueda de perfiles, búsqueda de Space/temas |
| H&M | 6 | Búsqueda por palabra clave + sugerencias, listados de tiendas por país, países/idiomas, árbol de categorías, divulgación de proveedores y fábricas por producto |
| Spotify | 6 | Artistas, pistas, álbumes, podcasts, episodios, búsqueda |
| Threads | 6 | Perfiles, publicaciones, comentarios de publicaciones, búsqueda por palabra clave, búsqueda de usuarios |
| Google Shopping | 5 | Búsqueda de productos, detalles de productos, historial de precios, reseñas entre minoristas, ofertas por vendedor |
| Kohl's | 5 | Búsqueda por palabra clave, reseñas, preguntas y respuestas de productos, búsqueda de tiendas, árbol de categorías |
| 5 | Pines, tableros, búsqueda, conteos de guardados por URL | |
| Rumble | 5 | Búsqueda, videos de canales, detalles de videos, comentarios, transcripciones |
| Target | 5 | Detalles de productos por TCIN, reseñas, navegación por categorías, taxonomía completa, búsqueda de tiendas |
| TikTok Shop | 5 | Productos, reseñas, listados, búsqueda, vitrinas de creadores |
| Walmart | 5 | Detalles de productos, reseñas, búsqueda por palabra clave, navegación por categorías, ofertas de vendedores |
| Yelp | 5 | Perfiles de negocios por encid, reseñas de negocios, búsqueda de negocios (compacta y tarjeta completa), sugerencias de búsqueda |
| Apple Music | 4 | Búsqueda de catálogo, artista, álbum, pista |
| Etsy | 4 | Listados por id o URL, catálogo de una tienda, listados similares, sugerencias de búsqueda |
| Hacker News | 4 | Búsqueda de historias, historia, árbol de comentarios, perfil |
| Home Depot | 4 | Búsqueda por palabra clave, detalles de productos por id de artículo o URL (precios según tienda/código postal), reseñas, búsqueda de tiendas por código postal |
| Tavily | 4 | Búsqueda web (con respuesta de LLM), extracción de URL, mapa del sitio, rastreo completo |
| Twitch | 4 | Perfiles, clips, videos, horarios |
| Búsqueda Universal | 4 | Una consulta distribuida en 14 plataformas (tarifa plana de 20cr); carril de foros; carril de noticias multinacional (medido); carril de descubrimiento de creadores en TikTok/Threads/Instagram |
| Utilidad | 4 | Autodescubrimiento gratuito de API: inicio rápido, catálogo de endpoints, guía de uso por endpoint, carga útil de contexto de LLM. 0 créditos, servido desde el registro en vivo. Impulsado por socialcrawl_discover |
| Bluesky | 3 | Perfiles, publicaciones |
| Kwai | 3 | Perfiles, publicaciones |
| Telegram | 3 | Perfiles de canales públicos, feeds de publicaciones de canales, búsqueda de una sola publicación |
| Truth Social | 3 | Perfiles, publicaciones |
| Wayfair | 3 | Búsqueda de productos, detalles de productos por SKU, reseñas |
| eBay | 2 | Búsqueda de anuncios incl. vendidos/completados con precios realizados, detalles de anuncios |
| Google Trends | 3 | Interés a lo largo del tiempo (explorar), consultas relacionadas en aumento/destacadas y tendencias actuales por ubicación |
| Snapchat | 2 | Perfiles, comentarios de Spotlight |
| Trustpilot | 2 | Búsqueda de negocios, reseñas de empresas |
| Google News | 1 | Búsqueda en tiempo real de SERP de Google News |
| Kick | 1 | Clips |
| Komi | 1 | Páginas de enlaces |
| LinkBio | 1 | Páginas de enlaces |
| LinkMe | 1 | Páginas de enlaces |
| Linktree | 1 | Páginas de enlaces |
| On-Page | 1 | Auditoría SEO on-page de una sola URL: los controles técnicos, de contenido y meta en una sola llamada |
| Perplexity | 1 | Investigación web Sonar con fuentes citadas |
| Pillar | 1 | Páginas de enlaces |
| Polymarket | 1 | Investigación de mercados de predicción: distribución de múltiples consultas + clasificación |
Total: 575 endpoints en 65 plataformas.
Manejo de Errores
El servidor MCP maneja los errores con elegancia y brinda al agente orientación práctica. Cada error de API pasa el propio error.message del servidor, seguido de reason: … cuando la API nombra uno y request_id: req-… en su propia línea (leído del cuerpo, o el encabezado X-Request-Id cuando el cuerpo no es JSON). Cita el request_id cuando reportes un problema: es cómo se encuentra una llamada en los registros y en el libro mayor de créditos.
| Error | Lo que ve el agente |
|---|---|
| Falta la clave de API | Solicita configurar SOCIALCRAWL_API_KEY con enlace para registrarse |
| Clave de API inválida | Pide verificar la configuración de la clave |
| Créditos insuficientes | Muestra el saldo y enlaza a la página de facturación |
| Plataforma/recurso incorrecto | Sugiere usar herramientas de descubrimiento para encontrar el endpoint correcto |
| Parámetros faltantes | Enumera exactamente lo que falta con ejemplos: detectado localmente, antes de la facturación |
| Valor de parámetro inválido | Nombra el valor de enumeración ilegal, el entero fuera de rango, el acoplamiento roto o el CSV demasiado largo: detectado localmente, antes de la facturación |
| Recurso no encontrado (404) | La razón del servidor por la que falta el elemento (p. ej., reason: video_gone) y si se te cobró (BIL-01) |
| Conflicto de clave de idempotencia (409) | Informa al agente que la clave fue utilizada por otra cuenta: genera una nueva |
| Desajuste de carga útil de clave de idempotencia (422) | Informa al agente que la misma clave se reutilizó con parámetros diferentes |
| Método no permitido (405) | Reporta el método HTTP incorrecto para esa ruta |
| Carga útil demasiado grande (413) | Cuerpo de solicitud por encima del límite de tamaño JSON; rechazado antes del análisis |
| Límite de velocidad (429) | Por encima de la ventana de 600 req/min por clave: sin facturar; retrocede y reintenta |
| Límite de concurrencia (429) | Pide al llamante que retroceda (50 concurrentes/clave como máximo) |
| Presupuesto de clave excedido (402) | El límite de gasto de esta clave se agotó mientras la cuenta aún tiene créditos: aumenta el límite, no recargues |
| Error ascendente (502) | El relato del servidor sobre qué plataforma falló, el reembolso y cuándo reintentar |
| Plataforma no disponible (503) | La causa del servidor (interruptor de circuito abierto o limitación ascendente) y sugerencia de reintento; créditos reembolsados |
Enlaces
- Obtén tu Clave de API — 100 créditos gratuitos, sin necesidad de tarjeta de crédito
- Documentación de la API — referencia completa de endpoints, créditos y códigos de error
- Sitio web de SocialCrawl
- Paquete npm
- Registro MCP
- Guía de Inicio
- Cómo Funciona