lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

herramienta intermedio claude-codecodexclipodscan

Podscan CLI: consulta episodios y alertas para investigar conversaciones

Localiza episodios por su transcripción y consulta las alertas de Podscan para investigar qué se dice de un tema o una marca.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara el acceso

Comprueba que tienes Node.js ≥22.20.0 y npm/npx, Go ≥1.26.10 y el directorio de binarios en PATH (metadatos del instalador). Obtén un token con acceso a la API; lo configurarás después de instalar.

Paso 2: instala la CLI

El instalador compila con Go; .go-version fija 1.26.10. Su instalación de skills exige Node ≥22.20.0 aunque el catálogo acepte ≥20. Ejecuta el comando del README:

npx -y @mvanhorn/printing-press-library install podscan

El binario instalado se llama podscan-pp-cli. El instalador usa ~/.local/bin en macOS/Linux o %LOCALAPPDATA%\Programs\PrintingPress\bin en Windows. Si falta en PATH, aplica la línea para tu sistema que imprima el instalador y abre una terminal nueva.

Paso 3: autentica y prueba el flujo documentado

Configura PODSCAN_BEARER_AUTH como variable de entorno privada en la terminal donde vas a ejecutar la CLI.

Ejecuta los comandos en este orden. Los términos, dominios e identificadores de ejemplo se sustituyen por los que correspondan a tu trabajo.

podscan-pp-cli doctor
podscan-pp-cli alerts list
podscan-pp-cli episodes search --query "inteligencia artificial" --per-page 5 --json

Comprobación

Comprueba que cada comando termina correctamente y que la salida corresponde a la cuenta, fuente o datos que seleccionaste. Una lista vacía no demuestra que el dato no exista: comprueba primero el alcance de la consulta y, si usas una copia local, su sincronización.

Si algo falla

Si falla la autenticación, revisa el token y su acceso a la API. Una lista de alertas vacía puede significar que aún no has creado ninguna. Consulta el README de esta CLI para las opciones específicas de tu sistema y versión. No compartas credenciales en la salida de diagnóstico.

ver en .md ¿Prefieres el recurso entero?

Qué es

Podscan CLI conecta la terminal con la API REST de Podscan. Da acceso a búsquedas de podcasts y episodios, transcripciones y alertas en un formato que puede consumir un agente. Forma parte de Printing Press Library y tiene código y documentación propios dentro del catálogo.

Para qué te sirve

  • Cuando buscas episodios donde se hable de un problema de tus clientes.
  • Cuando quieres revisar las alertas configuradas antes de preparar un informe de menciones.

Cómo funciona

Los comandos separan episodios, programas, categorías, alertas y exportaciones. La búsqueda de episodios trabaja sobre el contenido de la transcripción; la de podcasts usa nombre o descripción. La salida JSON facilita incorporar resultados a otro flujo.

Antes de empezar

Necesitas una cuenta con acceso a la API de Podscan y un token válido; revisa las condiciones de tu plan. La instalación recomendada con Node.js ≥22.20.0, npm/npx y Go ≥1.26.10 incorpora el binario y su skill para agentes; las alternativas están en el README de esta herramienta. La carpeta contiene una licencia Apache-2.0; GitHub no detecta una licencia global para el catálogo.

Límites y alternativas

El alcance depende de la cobertura y disponibilidad de Podscan. Una mención encontrada necesita leerse en contexto. La web de Podscan sirve para búsquedas manuales; Podcast GOAT es otra opción cuando ya tienes la URL de un episodio.

Recursos