Signal Lab Apify Tools
Usa Signal Lab como una habilidad de enrutamiento para un conjunto pequeño de flujos de trabajo enfocados con datos públicos. Prefiere el Actor más específico que coincida con la tarea, mantén las entradas acotadas y trata el esquema de entrada en vivo del Actor de Apify y la pestaña de Precios como la fuente de verdad.
Cuándo Usarlo
- El usuario necesita subtítulos públicos disponibles de YouTube o segmentos de subtítulos con marca de tiempo para investigación, RAG o análisis.
- El usuario necesita un sitio web público o un rastreo acotado dentro del mismo dominio convertido a Markdown limpio para RAG, búsqueda semántica, indexación o análisis con LLM.
- El usuario ya tiene una o más URL públicas de ofertas de empleo y necesita campos de empleo normalizados, especialmente datos de
JobPostingde Schema.org cuando la página los expone. - El usuario necesita seguimiento de precios o disponibilidad de productos públicos de Amazon, sugerencias de palabras clave de Google Autocomplete en vivo, investigación pública en Reddit o extracción de menús de restaurantes compatibles.
- Un cliente compatible con MCP debe exponer uno o más Actores de Signal Lab como herramientas a través del servidor MCP alojado de Apify.
- Un flujo de trabajo sin MCP debe llamar al Actor correspondiente a través de la API REST de Apify y consumir su Dataset.
Cuándo No Usarlo
- La tarea requiere evadir muros de inicio de sesión, muros de pago, CAPTCHAs, restricciones de robots, controles antibot, páginas privadas u otros controles de acceso.
- El usuario solicita la transcripción de audio de un video de YouTube sin una pista de subtítulos públicos accesible; el Actor de YouTube extrae los subtítulos disponibles y no es un servicio de conversión de voz a texto.
- El sitio web requiere renderizado JavaScript del lado del cliente que un rastreador solo HTTP no puede proporcionar; no afirmes que el Actor de Sitio Web a Markdown renderiza SPAs.
- El usuario desea descubrimiento amplio de tablones de empleo en lugar de extracción de URL públicas de empleo compatibles conocidas; no impliques que el Job Vacancy Scraper busca en todos los tablones de empleo.
- La fuente o el uso solicitado violaría las leyes aplicables, requisitos de privacidad, obligaciones de derechos de autor, términos del sitio o la autorización del usuario.
- La tarea puede responderse directamente sin ejecución de datos externos; no inicies un Actor solo para demostrar la habilidad.
Flujo de Trabajo
- Identifica la necesidad exacta de datos y selecciona la herramienta más específica que coincida.
- Subtítulos de YouTube:
signal_lab/youtube-transcript-scraper - Sitio web a Markdown:
signal_lab/website-to-markdown-crawler - Extracción de URL de empleo público conocida:
signal_lab/job-vacancy-scraper - Seguimiento de precios de Amazon:
signal_lab/amazon-price-tracker - Investigación de Google Autocomplete:
signal_lab/google-autocomplete-keywords - Investigación pública en Reddit:
signal_lab/reddit-search-comments - Extracción de menús de restaurantes:
signal_lab/restaurant-menu-extractor
- Subtítulos de YouTube:
- Lee el esquema de entrada en vivo del Actor de Apify y la pestaña de Precios antes de ejecutar. Los precios, la disponibilidad y el esquema pueden cambiar; los ejemplos de documentación no sustituyen al estado en vivo.
- Elige la superficie de ejecución.
- Prefiere MCP alojado en Apify cuando el cliente sea compatible con MCP y el usuario pueda autenticarse con Apify.
- De lo contrario, usa la API REST de Actor de Apify con el token de Apify del usuario.
- Comienza con la entrada acotada más pequeña y útil.
- Para rastreos, minimiza primero el número de páginas y la profundidad.
- Para listas de URL/videos/productos, prueba un subconjunto pequeño antes de expandir.
- Nunca aumentes el gasto o el alcance solo para recopilar más datos.
- Espera a que la ejecución termine, luego consume el Dataset predeterminado o la salida documentada del Actor.
- Verifica que los campos devueltos realmente provinieron de la fuente. La ausencia de campos fuente no es evidencia de que existan.
- Escala solo después de que el primer resultado acotado sea útil y el usuario acepte los precios/economía en vivo.
Enlaces Directos a las Herramientas
Usa estas páginas canónicas de la Tienda cuando un usuario o agente necesite inspeccionar el esquema en vivo, la pestaña de Precios, ejemplos o iniciar una ejecución:
- Subtítulos de YouTube: https://apify.com/signal_lab/youtube-transcript-scraper
- Sitio web a Markdown: https://apify.com/signal_lab/website-to-markdown-crawler
- Extracción de URL de empleo público conocida: https://apify.com/signal_lab/job-vacancy-scraper
- Seguimiento de precios de Amazon: https://apify.com/signal_lab/amazon-price-tracker
- Investigación de Google Autocomplete: https://apify.com/signal_lab/google-autocomplete-keywords
- Investigación pública en Reddit: https://apify.com/signal_lab/reddit-search-comments
- Extracción de menús de restaurantes: https://apify.com/signal_lab/restaurant-menu-extractor
Para clientes MCP, expón solo la(s) herramienta(s) necesaria(s) para la tarea actual a través del servidor MCP alojado de Apify, en lugar de darle al agente una superficie de herramientas más amplia de lo necesario.
Manejo de Fallos, Reintentos y Costos
- Trata el HTTP
429como contrapresión, no como permiso para aumentar la concurrencia. RespetaRetry-Aftercuando esté presente; de lo contrario, usa retroceso exponencial acotado con jitter. - Reintenta fallos transitorios
5xx, de red o de tiempo de espera solo un número pequeño de veces. No reintentes errores deterministas de validación/autenticación4xxhasta que se corrija el problema de entrada o autenticación. - Si una ejecución de Actor alcanza
FAILED,TIMED-OUToABORTED, inspecciona el estado de la ejecución/evidencia de los registros antes de decidir si un reintento está justificado. Nunca hagas un bucle de reintentos pagados a ciegas. - Para el sondeo, retrocede entre verificaciones de estado en lugar de golpear la API. Deja de sondear una vez que la ejecución sea terminal.
- Mantén la entrada original acotada al reintentar. No aumentes
maxPages, recuentos de elementos, profundidad de rastreo, concurrencia o alcance del proxy como respuesta genérica a fallos. - Vuelve a verificar la pestaña de Precios en vivo antes de expandir materialmente un reintento o lote. Una solicitud API exitosa no significa que la ejecución posterior sea gratuita.
- Detente e informa el bloqueador si los reintentos transitorios repetidos fallan, la fuente bloquea el acceso legítimo, la autenticación no está disponible o el siguiente intento aumentaría materialmente el gasto.
- Nunca conviertas una ejecución pagada fallida en una excusa para iniciar un Actor pagado diferente sin una clara adecuación a la tarea y una economía autorizada por el usuario.
Reglas
- Siempre usa la autenticación de Apify del propio usuario para la ejecución pagada o la autorización MCP.
- Nunca incrustes, expongas, actúes como proxy o solicites las credenciales del propietario de Signal Lab.
- Nunca trates un contador de ejecuciones públicas de Actor, el total de usuarios, un listado de directorio o una solicitud API exitosa como prueba de ingresos del creador.
- Nunca prometas campos que la página fuente o la pista de subtítulos no exponga.
- Nunca declares capacidades de evasión de controles de acceso.
- Prefiere llamadas reversibles y acotadas y el volumen mínimo de datos requerido.
- Usa la pestaña de Precios en vivo de Apify como la fuente de verdad comercial antes de la ejecución.
- Para Sitio web a Markdown, respeta su limitación de rastreador HTTP y los controles de rastreo acotados.
- Para YouTube, describe la salida como subtítulos/marcas de tiempo públicos disponibles, no como transcripción generada.
- Para la extracción de ofertas de empleo, descríbela como extracción de URL públicas conocidas y análisis consciente de Schema.org, no como búsqueda universal de empleo.
Ejemplos
Subtítulos de YouTube para RAG
Necesidad del usuario: "Obtén marcas de tiempo de estos videos públicos de YouTube para construir un índice RAG con citas."
Usa signal_lab/youtube-transcript-scraper con un conjunto pequeño de URL públicas, solicita segmentos con marca de tiempo y luego conserva la URL fuente, el idioma, el texto de la transcripción y el tiempo del segmento al construir el índice posterior.
Documentación de sitio web a Markdown
Necesidad del usuario: "Convierte este sitio de documentación en un pequeño corpus Markdown para mi LLM."
Usa signal_lab/website-to-markdown-crawler. Comienza con una página o un valor bajo de maxPages, mantén sameDomainOnly habilitado, mantén la profundidad de rastreo baja y respeta las reglas de robots. Inspecciona las primeras filas del Dataset antes de expandir.
Oferta de empleo conocida a JSON estructurado
Necesidad del usuario: "Normaliza título, empresa, ubicación, salario y fechas de estas cinco URL de empleo."
Usa signal_lab/job-vacancy-scraper solo para las URL públicas proporcionadas. Devuelve los campos que las páginas realmente exponen y señala los valores faltantes en lugar de inventarlos.
Conexión MCP
Para una herramienta enfocada de Sitio web a Markdown, un cliente compatible con MCP puede usar:
{
"mcpServers": {
"signal-lab-markdown": {
"url": "https://mcp.apify.com?tools=signal_lab/website-to-markdown-crawler"
}
}
}
Apify maneja la autenticación. No coloques un token de propietario en la configuración compartida.
Casos Especiales
- Si la autenticación de Apify no está disponible, proporciona la ruta correcta del Actor o la conexión MCP, pero no ejecutes trabajo pagado con las credenciales de otra persona.
- Si el esquema en vivo del Actor difiere de esta habilidad, sigue el esquema en vivo y actualiza las suposiciones en consecuencia.
- Si la página es solo JavaScript y el rastreador HTTP devuelve contenido incompleto, detente y explica la limitación de renderizado en lugar de escalar a técnicas de evasión de controles de acceso.
- Si YouTube no expone subtítulos públicos utilizables, detente e informa esa limitación; no cambies silenciosamente a un producto de transcripción pagado diferente.
- Si una página de empleo carece de salario o metadatos estructurados, devuelve los campos que están verificablemente presentes y marca el resto como faltantes.
- Si una ejecución solicitada podría volverse grande o costosa, reduce la entrada inicial y solicita aprobación antes de expandir materialmente el gasto.
Referencias
- Centro de desarrollo de Signal Lab: https://first-livid-omega.vercel.app/
- Índice de descubrimiento de agentes de IA: https://first-livid-omega.vercel.app/llms.txt
- Identidad del Registro MCP Oficial:
io.github.VZezelin/signal-lab-apify-tools - Búsqueda en el Registro MCP Oficial: https://registry.modelcontextprotocol.io/?q=io.github.VZezelin%2Fsignal-lab-apify-tools
- Signal Lab en Apify: https://apify.com/signal_lab
- Guía de la API de Transcripción de YouTube: https://first-livid-omega.vercel.app/youtube-transcript-api.html
- Guía de la API de Sitio web a Markdown: https://first-livid-omega.vercel.app/website-to-markdown-api.html
- Guía de la API de Job Posting Scraper: https://first-livid-omega.vercel.app/job-posting-scraper-api.html