Recursos
- Scrape Creators CLI en GitHub - la CLI que convierte los 164 endpoints de Scrape Creators de 28 plataformas en comandos tipados.
- Scrape Creators - la API de pago que usa esta CLI. Aquí compras créditos y obtienes tu clave de API.
- Documentación de Scrape Creators - la referencia de endpoints, útil para saber exactamente qué devuelve una plataforma.
- Printing Press Library - el catálogo más amplio de CLI pensadas para agentes en el que se incluye esta herramienta.
Cómo funciona
Scrape Creators es un servicio de pago que extrae datos públicos (perfiles, publicaciones, videos, transcripciones y creatividades publicitarias) de 28 plataformas como TikTok, Instagram, YouTube, LinkedIn y Facebook, todo con una clave de API.
Esta CLI es un programa de línea de comandos (una herramienta que ejecutas escribiendo comandos en tu terminal, la ventana de texto donde das instrucciones a tu equipo) que convierte cada uno de esos 164 endpoints en un comando tipado sencillo que puede ejecutar tu agente.
También añade lo que no tiene la API por sí sola: un almacén local en tu máquina que guarda las transcripciones, los perfiles y las creatividades que recuperas, para volver a buscarlos después sin gastar otro crédito.
El hub ya tiene Scrape Creators MCP, y esta CLI es su equivalente deliberado de línea de comandos, porque es más rápida, usa menos tokens del agente y ofrece comandos multiplataforma (como encontrar a un creador en todas las plataformas a la vez) que ninguna herramienta MCP individual ofrece.
Paso 1: obtén tu clave de API de Scrape Creators
Esta herramienta se comunica con una API de pago, así que necesitas una cuenta y una clave antes de poder ejecutar nada.
Ve a scrapecreators.com, regístrate y copia tu clave de API del panel.
Las cuentas nuevas reciben créditos gratis para empezar, suficientes para probar todos los comandos de esta guía.
Después el servicio es de pago por uso: cada solicitud gasta créditos, los créditos no caducan y, cuando el saldo llega a cero, la API devuelve un error en lugar de datos.
Es importante ser claro desde el principio, porque, a diferencia de una herramienta gratis de código abierto, cada comando de abajo cuesta una pequeña cantidad de dinero real cuando se agotan los créditos gratis.
Paso 2: instala la CLI
Abre tu terminal e instala la herramienta con un comando.
npx -y @mvanhorn/printing-press-library install scrape-creatorsEsto instala el comando scrape-creators-pp-cli y una skill de agente (un pequeño paquete de instrucciones que enseña a tu agente de programación a usar la herramienta).
Si no tienes Node.js instalado, puedes instalar solo el comando con Go (un lenguaje de programación que quizá ya tengas).
go install github.com/mvanhorn/printing-press-library/library/developer-tools/scrape-creators/cmd/scrape-creators-pp-cli@latestEl resultado correcto es que el comando termine sin texto de error en rojo y deje disponible scrape-creators-pp-cli para invocarlo desde cualquier lugar.
Paso 3: guarda tu clave de API
La CLI lee tu clave de una variable de entorno (un valor con nombre que recuerda tu terminal), para que nunca la pegues en un comando.
Defínela una vez en tu terminal.
export SCRAPECREATORS_API_KEY="your-key-here"Sustituye your-key-here por la clave que copiaste en el paso 1.
Para guardarla de forma permanente, ejecuta el comando de inicio de sesión integrado, que almacena la clave de forma segura en tu máquina.
scrape-creators-pp-cli auth loginEl resultado correcto es que la herramienta confirme que guardó tu clave, de modo que los comandos futuros la encuentren por sí solos.
Paso 4: comprueba que todo esté conectado
Antes de gastar un solo crédito, confirma que la herramienta accede a la API y tu clave funciona.
scrape-creators-pp-cli doctorEsto ejecuta una comprobación de estado que verifica tu clave y la conexión sin gastar créditos.
El resultado correcto es un informe con marcas verdes y sin errores de autenticación.
Si ves un error de autenticación, falta tu clave o es incorrecta: repite el paso de inicio de sesión y comprueba que no tenga erratas.
Paso 5: comprueba tu saldo de créditos antes de una extracción grande
Como cada comando real gasta créditos, conviene comprobar primero cuánto te queda.
scrape-creators-pp-cli account budget --agentInforma de la velocidad a la que gastas y de cuántos días de créditos te quedan aproximadamente a ese ritmo.
La opción --agent hace que la salida sea JSON limpio, sin colores ni preguntas, el formato que mejor lee tu agente.
El resultado correcto es un resumen breve del saldo y el ritmo de consumo para que un lote grande de llamadas no se quede sin créditos a mitad.
Paso 6: encuentra a un creador en todas las plataformas a la vez
Este es el comando que hace que la CLI valga más que la API por sí sola: le das un nombre de usuario y encuentra a ese creador en todas las plataformas principales con una llamada.
scrape-creators-pp-cli creator find mrbeast --agentSustituye mrbeast por el nombre de usuario que te interese.
En lugar de hacer once consultas separadas a mano, esto devuelve la presencia del creador y su número de seguidores entre plataformas, en paralelo.
El resultado correcto es una tabla de plataformas con cifras de seguidores, la forma más rápida de evaluar a un creador antes de contactarlo.
Para comparar a dos creadores por interacción en lugar de solo por número de seguidores, compáralos directamente.
scrape-creators-pp-cli creator compare mkbhd mrwhosetheboss --agent --select handle,engagement_rate,follower_countLa opción --select reduce la salida a los campos que indiques, lo que mantiene la respuesta pequeña y barata de leer para tu agente.
Paso 7: descubre en qué plataforma destaca más una tendencia
Cuando un tema empieza a moverse, quieres saber dónde está despegando primero para publicar tu contenido en el momento adecuado.
scrape-creators-pp-cli trends triangulate "stanley cup" --agentSustituye "stanley cup" por cualquier etiqueta o tema entre comillas.
Esto toma una instantánea del tema entre plataformas con una llamada y muestra en cuál lidera.
El resultado correcto es un desglose por plataforma de la fuerza del tema en cada una para aprovechar una tendencia antes de su punto máximo.
Paso 8: sigue los anuncios de un competidor y descubre qué cambió
Las bibliotecas de anuncios permiten ver la publicidad que tiene activa una marca, y este comando obtiene sus anuncios activos en Facebook, TikTok, Google y LinkedIn a la vez.
scrape-creators-pp-cli ads monitor nike --agentSustituye nike por la marca que quieras seguir.
La primera ejecución te da todos los anuncios que la marca tiene activos en ese momento.
Cada ejecución posterior compara con la anterior e indica qué anuncios son nuevos y cuáles desaparecieron, de modo que repetirlo cada semana se convierte en un informe automático de cambios.
El resultado correcto es una lista de anuncios actuales en la primera ejecución y después una comparación más breve de nuevos y retirados.
Paso 9: crea una biblioteca de transcripciones consultable sin conexión
Las transcripciones son las palabras habladas de un video convertidas en texto, y obtenerlas cuesta créditos cada vez.
La CLI guarda cada transcripción que recuperas en un almacén local de tu máquina para que después busques en ese material gratis.
Primero obtén algunas transcripciones con los comandos de cada plataforma (por ejemplo, de videos de YouTube o TikTok), que las guardan en caché automáticamente.
Después busca en todo lo guardado con una búsqueda de texto completo.
scrape-creators-pp-cli transcripts search "giveaway" --agent --select creator,platform,snippetSustituye "giveaway" por cualquier palabra o frase que quieras buscar en todo tu corpus guardado.
Esto busca en texto por cuya recuperación ya pagaste, así que no gasta nuevos créditos. Es ideal para revisiones de seguridad de marca o para encontrar todos los videos que mencionaron un tema.
El resultado correcto es una lista de fragmentos coincidentes con su creador y plataforma, obtenidos de tu almacén local.
Configuración con Claude Code
Claude Code es el agente de programación de Anthropic que se ejecuta en tu terminal, y la instalación predeterminada ya añadió una skill que le enseña todos los comandos.
Claude Code, paso 1: confirma que la skill está instalada
La instalación de una línea del paso 2 ya añadió la skill de Claude Code; solo confirma que esté ahí.
npx -y @mvanhorn/printing-press-library install scrape-creators --agent claude-codeEsto garantiza que estén presentes los archivos de la skill específicos de Claude Code.
Claude Code, paso 2: pídele que ejecute una tarea real
Ahora puedes hablar con Claude Code en lenguaje natural y recurrirá por sí solo al comando adecuado.
Pega esto en tu terminal de Claude Code:
Usando scrape-creators-pp-cli, averigua en qué plataformas está el creador "mkbhd"
y compara sus cifras de seguidores. Usa la opción --agent para que la
salida sea JSON limpio y comprueba primero mi saldo de créditos con account budget.Claude Code ejecutará account budget y después creator find, y te devolverá los resultados.
El resultado correcto es que el agente ejecute comandos reales de scrape-creators-pp-cli en lugar de inventar una herramienta falsa.
Configuración con OpenClaw
OpenClaw es un agente de IA con el que conversas y usa el mismo sistema de skills con una opción de instalación ligeramente distinta.
OpenClaw, paso 1: instala la CLI y la skill de OpenClaw
Ejecuta el instalador dirigido a OpenClaw para que coloque tanto el comando como el paquete de instrucciones correspondiente.
npx -y @mvanhorn/printing-press-library install scrape-creators --agent openclawSi la skill nueva no aparece de inmediato, reinicia tu sesión de OpenClaw para que cargue los archivos.
OpenClaw, paso 2: dale una tarea por chat
Pide a OpenClaw un resultado real en lenguaje natural.
Pega esto en tu chat de OpenClaw:
Usa scrape-creators-pp-cli para seguir los anuncios activos de Nike en Facebook,
TikTok, Google y LinkedIn con "ads monitor nike --agent". Resume cuántos
anuncios hay activos y en qué plataformas.OpenClaw ejecutará el comando y te resumirá los resultados de las bibliotecas de anuncios.
El resultado correcto es que OpenClaw devuelva un resumen real de anuncios en lugar de adivinar.
Configuración con Hermes
Hermes es un agente pensado para usarse desde el teléfono que vive en un servidor remoto, así que primero instalas la parte de línea de comandos y después añades su skill específica.
Hermes, paso 1: instala el binario de la CLI
Instala solo el comando en la máquina donde se ejecuta Hermes.
npx -y @mvanhorn/printing-press-library install scrape-creators --cli-onlyEl instalador coloca el comando en una carpeta del usuario para que Hermes pueda invocarlo.
Hermes, paso 2: instala la skill de Hermes
Añade la skill específica de Hermes desde una sesión de chat de Hermes.
/skills install mvanhorn/printing-press-library/cli-skills/pp-scrape-creators --forceReinicia la sesión de Hermes si la skill no aparece de inmediato.
Hermes, paso 3: pide a Hermes que investigue a un creador
Envía a Hermes una tarea en lenguaje natural por tu canal de chat habitual.
Usa scrape-creators-pp-cli para ejecutar "creator find mrbeast --agent" y dime
en qué plataformas está MrBeast con sus cifras de seguidores. Comprueba primero mi presupuesto de créditos.El resultado correcto es que Hermes ejecute el comando y te envíe el desglose entre plataformas.
Paso 10: usa el prompt para crear una tarea de investigación repetible
Pega el prompt de la pestaña Prompt de arriba en tu agente de programación para que construya un script completo y reutilizable de una tarea de investigación que hagas a menudo (por ejemplo, obtener los anuncios de una marca cada lunes o encontrar a todos los creadores de un nicho y ordenarlos por interacción).
Sustituye [GOAL] por el resultado que quieres en lenguaje natural, [HANDLE_OR_BRAND] por la cuenta o marca que consultarás y [PLATFORMS] por las plataformas que importan.
El prompt indica al agente que compruebe primero tu presupuesto de créditos, use solo comandos reales y añada las opciones --agent y --select para que cada llamada siga siendo barata.
El resultado correcto es que el agente te entregue un script breve y ejecutable que haga el trabajo de principio a fin sin desperdiciar créditos.
Paso 11: conoce las trampas de los créditos antes de sufrirlas
Estos son los problemas reales que encuentran los operadores para que puedas evitarlos.
Cada solicitud cuesta créditos y un saldo agotado devuelve un error HTTP 402 a mitad de la tarea. Por eso ejecutar account budget antes de una tarea grande marca la diferencia entre terminarla y que se interrumpa a mitad.
Algunos endpoints cuestan más que otros: obtener detalles completos de anuncios o datos demográficos de audiencia puede gastar muchos créditos por llamada en lugar de uno, así que consulta cuánto cobra un comando antes de repetirlo sobre una lista grande.
Las transcripciones solo funcionan en videos de menos de dos minutos y solo se cobra cuando se devuelve una transcripción, así que un resultado nulo no te cuesta nada.
La API funciona en infraestructura con un límite estricto de unos treinta segundos por llamada, así que las solicitudes de transcripciones o listas grandes de publicaciones pueden agotar el tiempo. En ese caso, acota la solicitud a un solo usuario o añade un límite y reintenta.
De vez en cuando una plataforma sufre una caída en origen (por ejemplo, las páginas de la biblioteca de anuncios de TikTok) mientras las demás siguen funcionando. Si una plataforma da error y las otras no, comprueba la página de estado de Scrape Creators y vuelve a probar esa plataforma más tarde.
