La conexión general no requiere elegir una aplicación primero. Este tutorial y los tutoriales «Codex: conectar una aplicación específica» y «Claude Code: conectar una aplicación específica» son dos patrones de uso distintos. La conexión a una aplicación específica se adapta a una capacidad clara, fija y de largo plazo. La conexión general se adapta a necesidades cambiantes o a casos en los que la aplicación aún no se ha elegido.
Entender los dos métodos de conexión
Ambos métodos llaman a las mismas Data Apps de Data Hub. La única diferencia es dónde eliges la aplicación. Puedes mantener ambos tipos de conexión, pero dales nombres reconocibles para que el agente no elija la herramienta equivocada.
Qué podrás hacer después
Tras este tutorial, podrás hacer lo siguiente dentro de tu agente, en orden:- Buscar Data Apps por palabra clave, plataforma o escenario.
- Revisar el propósito, los parámetros de entrada, los campos de salida y la facturación de una aplicación.
- Confirmar la aplicación y los parámetros y luego iniciar una ejecución.
- Comprobar el estado de una tarea asíncrona y obtener el resultado final.
Para los parámetros completos y las reglas de gestión de
search_data_apps, run_data_app, las comprobaciones de estado asíncronas y el handoff de resultados grandes, consulta Capacidades MCP de Data Hub. Esta página se centra en la conexión y el primer uso.Antes de empezar
Ten preparado lo siguiente:- Una cuenta de Octoparse con la que puedas iniciar sesión.
- Un cliente de agente compatible con Streamable HTTP MCP, como Claude Code, Codex o Cursor.
- Si eliges el método de clave API: crea una clave API de Octoparse con antelación.
- Un objetivo de datos sencillo para probar, como «encontrar una Data App que pueda enriquecer información de empresas».
Paso 1: abrir la conexión MCP general
1
Ir a la Data Hub Open Platform
Inicia sesión en el sitio web de Octoparse, abre el menú Data Hub en la parte superior y haz clic en Data Hub Open Platform.
2
Abrir MCP connection
En la navegación izquierda de la Open Platform, haz clic en MCP connection para abrir la página Data Hub MCP Server. El conjunto de herramientas predeterminado que muestra la página puede buscar y ejecutar cualquier Data App de Data Hub. No necesitas elegir primero una aplicación en el catálogo.
Paso 2: elegir un método de autenticación
La conexión general admite tanto clave API como OAuth. La elección solo afecta a la autenticación. No cambia cómo se buscan o ejecutan las Data Apps.Opción 1: clave API (recomendada)
Ideal para un uso estable a largo plazo, clientes de línea de comandos y automatización. La configuración generada por la página contiene:Bearer es simplemente el formato de cabecera usado para pasar la clave API. Usa una clave API de Octoparse, no un token de acceso temporal de una sesión del navegador con la sesión iniciada.
Si aún no tienes una clave, crea una en el centro de cuenta de Octoparse. Una clave API normalmente solo se muestra completa una vez, al crearla. Guárdala en un gestor de contraseñas de confianza.
Opción 2: inicio de sesión con OAuth
Ideal para clientes interactivos compatibles con MCP OAuth. Cuando eliges OAuth, la configuración no contiene ninguna clave API. La primera vez que el cliente se conecta, abre un navegador donde inicias sesión en Octoparse y confirmas la autorización. La sesión puede caducar, en cuyo caso vuelves a autorizar.Paso 3: copiar el prompt de instalación general
En la página MCP connection, elige tu cliente de agente y el método de autenticación, y luego haz clic en Copy install prompt. Copy MCP URL solo te da la dirección del servidor. Copia el contenido completo que la página genera en ese momento. No escribas de memoria la dirección del servidor, el alcance de las herramientas ni las cabeceras.Paso 4: dejar que el agente complete la configuración
El ejemplo siguiente usa Claude Code. Codex y Cursor colocan los botones de forma distinta, pero los pasos principales son los mismos: pegar el prompt de instalación, elegir el método de autenticación, permitir cambios en la configuración MCP del usuario actual y luego recargar el cliente.1
Enviar el prompt de instalación al agente
Inicia una conversación nueva y pega el prompt completo que copiaste. El agente debería preguntar el método de autenticación antes de escribir la configuración. Si intenta escribir credenciales en un archivo del proyecto, detenlo y pídele en su lugar la configuración MCP local del usuario actual.
2
Confirmar el método de autenticación
Si elegiste clave API, proporciona la clave de forma segura cuando el agente la pida. Si elegiste OAuth, no proporciones ninguna clave y deja que el agente escriba una configuración sin credenciales.
3
Recargar el cliente
Tras la configuración, recarga los servidores MCP o reinicia el cliente. Con OAuth, la primera conexión puede mostrar «Necesita autenticación». Es lo esperado.
Paso 5: completar la autorización OAuth (solo OAuth)
Si elegiste clave API, salta al paso siguiente.1
Activar la conexión en el cliente
En Claude Code, ejecuta
/mcp y selecciona el servidor Data Hub que acabas de añadir, llamado octoparse_datahub por defecto. Cuando indique que se necesita autenticación, elige autenticarte. Otros clientes muestran un botón Connect o similar en su configuración MCP.2
Iniciar sesión y autorizar en el navegador
El navegador abre la página de identidad de Octoparse. Comprueba el dominio y la cuenta actual, lee el alcance solicitado y confirma. Sigue la indicación de la página para volver al cliente. Algunos clientes vuelven automáticamente.
3
Confirmar que el servidor está habilitado
De vuelta en el cliente, confirma que el estado «Necesita autenticación» ha desaparecido y que el servidor está habilitado. Si sigue apareciendo como no autenticado, recarga el cliente e inténtalo de nuevo.
Paso 6: buscar primero, no ejecutar todavía
La clave de la conexión general es dejar que el agente descubra primero las Data Apps. En el primer uso, pídele explícitamente que solo busque y compare, y que no cree todavía ninguna tarea facturable. Por ejemplo:search_data_apps para buscar en el catálogo y luego a get_data_app_details para leer el contrato completo de cada candidata.
El número, los nombres y la cobertura de plataformas de las aplicaciones que encuentra un agente cambian en tiempo real con el catálogo de Data Hub. Esta documentación no ofrece una lista fija. Fíate de lo que
search_data_apps devuelve realmente.Paso 7: confirmar la aplicación y luego ejecutar
Elige una aplicación entre las candidatas. Pide al agente que repita los parámetros y las acciones previstas, y luego ejecuta una prueba pequeña:1
Comprobar las entradas y el coste
Confirma los parámetros obligatorios, el alcance de los datos, los campos devueltos y la unidad de facturación. Si algo no está claro, pide al agente que vuelva a llamar a la herramienta de detalles en lugar de adivinar los parámetros.
2
Ejecutar una prueba pequeña
Solo tras la confirmación, deja que el agente llame a
run_data_app. Una aplicación síncrona devuelve los resultados directamente. Una aplicación asíncrona necesita comprobaciones de estado posteriores.3
Obtener los resultados asíncronos
Para las tareas asíncronas, pide al agente que use las herramientas de estado y resultado para esperar a que termine y luego devolver los datos finales. No trates «tarea enviada» como una extracción correcta.
4
Comprobar los resultados
Comprueba el estado de la tarea, el número real de registros y los campos clave. Un campo ausente en un solo registro puede reflejar una diferencia en los datos de origen. Si la mayoría de los registros no coinciden con lo esperado, cambia de aplicación o ajusta los parámetros.
Preguntas frecuentes
¿La conexión general requiere elegir primero una Data App?
¿La conexión general requiere elegir primero una Data App?
No. La conexión general proporciona primero las herramientas de búsqueda y ejecución. Tras conectarse, el agente usa
search_data_apps para encontrar capacidades. Solo la conexión a una aplicación específica requiere elegir primero una aplicación en el catálogo.¿Debo elegir clave API u OAuth?
¿Debo elegir clave API u OAuth?
Prefiere la clave API para uso a largo plazo, clientes de línea de comandos y automatización. Elige OAuth cuando quieras iniciar sesión a través del navegador y tu cliente admita explícitamente MCP OAuth. Las sesiones OAuth pueden caducar y requerir una nueva autorización.
La configuración se completó, pero no hay herramienta search_data_apps
La configuración se completó, pero no hay herramienta search_data_apps
Confirma que usaste la configuración general de la página MCP connection de la Open Platform, no la configuración restringida de una aplicación específica. Copia de nuevo el prompt actual y recarga el cliente.
OAuth sigue indicando que se necesita autenticación
OAuth sigue indicando que se necesita autenticación
Activa la conexión en la configuración MCP del cliente, completa el inicio de sesión y la autorización en el navegador y vuelve al cliente. Comprueba si el navegador bloqueó la redirección y confirma que la página de autorización pertenece al servicio de identidad oficial de Octoparse.
El agente encontró una aplicación y la ejecutó de inmediato
El agente encontró una aplicación y la ejecutó de inmediato
Escribe explícitamente «solo buscar y comparar, no ejecutar todavía» en el prompt. Cuando haya costes o grandes volúmenes de datos de por medio, pide al agente que espere la confirmación antes de llamar a
run_data_app.La ejecución solo devolvió un ID de tarea y ningún dato
La ejecución solo devolvió un ID de tarea y ningún dato
La aplicación probablemente es asíncrona. Pide al agente que siga comprobando el estado de la tarea y que recupere los resultados cuando termine. No vuelvas a enviar la misma tarea.
Lista de comprobación
- Has copiado el prompt de instalación general desde la página MCP connection de la Data Hub Open Platform.
- Has elegido clave API u OAuth y no has mezclado las dos credenciales.
- El agente ha cargado las herramientas generales de Data Hub y puede usar
search_data_apps. - Has buscado y revisado los detalles de la aplicación antes de confirmar una ejecución.
- Has completado una llamada real con el volumen de datos más pequeño y has comprobado el resultado final.
¿Ya sabes qué aplicación usar?
Si tu negocio usa una aplicación fija a largo plazo, puedes reducir el alcance de la conexión:Codex: conectar una aplicación específica
Elige primero una aplicación concreta y luego añádela a Codex como herramienta fija.
Claude Code: conectar una aplicación específica
Elige primero una aplicación concreta y luego añádela a Claude Code como servidor MCP fijo.
El número real de aplicaciones, sus nombres, editores y precios devueltos por una búsqueda cambian con el catálogo de Data Hub. Fíate de lo que la herramienta devuelve en cada llamada.