Cómo usar CrawlForge con Smithery: guía del registro de MCP

Smithery es el mayor registro de MCP servers, con más de 100.000 herramientas e integraciones para agentes de IA. CrawlForge está listado en Smithery, lo que significa que puedes descubrir, instalar y gestionar tu MCP server de web scraping sin tocar manualmente un archivo de configuración.

Esta guía te lleva por el flujo de trabajo completo de Smithery, desde la búsqueda en el registro hasta la llamada a las herramientas de CrawlForge en producción.

Tabla de contenidos

• ¿Qué es Smithery?
• Requisitos previos
• Paso 1: Instala el CLI de Smithery
• Paso 2: Encuentra CrawlForge en Smithery
• Paso 3: Conéctate a CrawlForge
• Paso 4: Explora las herramientas disponibles
• Paso 5: Llama a las herramientas desde el CLI
• Paso 6: Usa namespaces para los entornos
• Referencia de costes en credits
• Cuándo usar Smithery frente a la instalación directa
• Próximos pasos

¿Qué es Smithery?

Smithery es un marketplace y registro de MCP servers. Piensa en él como npm para herramientas de agentes de IA. En lugar de configurar manualmente cada MCP server en el archivo de ajustes de tu cliente, Smithery ofrece un CLI y una interfaz web para buscar, instalar y gestionar conexiones MCP.

Smithery gestiona los flujos de OAuth, el almacenamiento de credenciales, la renovación de tokens y el ciclo de vida de la sesión automáticamente. Para equipos que ejecutan varios MCP servers en entornos de desarrollo y producción, esto elimina una sobrecarga de configuración considerable.

Requisitos previos

• Node.js 18+ instalado
• Una cuenta de CrawlForge con una API key (el plan gratuito incluye 1.000 credits)
• Acceso a la terminal (macOS, Linux o Windows con WSL)

Paso 1: Instala el CLI de Smithery

npm install -g @smithery/cli

Autentícate con tu cuenta de Smithery:

smithery auth login

Esto abre tu navegador para confirmar. Una vez autenticado, el CLI almacena tus credenciales localmente.

Paso 2: Encuentra CrawlForge en Smithery

Busca CrawlForge en el registro de Smithery:

smithery mcp search "crawlforge"

Verás CrawlForge listado con su descripción, número de herramientas (26 herramientas) y URL de conexión. También puedes explorar el catálogo web de Smithery para leer reseñas y documentación antes de instalarlo.

Paso 3: Conéctate a CrawlForge

Añade CrawlForge como una conexión MCP gestionada:

smithery mcp add "https://crawlforge.run.tools" \
  --id crawlforge \
  --metadata '{"apiKey": "cf_live_your_key_here"}'

Verifica el estado de la conexión:

smithery mcp list

Deberías ver crawlforge con el estado connected. Si muestra auth_required, sigue la URL de autorización que aparece en la salida.

Paso 4: Explora las herramientas disponibles

Lista las 26 herramientas de CrawlForge a través de Smithery:

# List all tool groups
smithery tool list crawlforge

# Drill into extraction tools
smithery tool list crawlforge extract.

# Inspect a specific tool's input/output schema
smithery tool get crawlforge extract_content

El comando tool get muestra el esquema JSON completo de cada herramienta, incluyendo los parámetros obligatorios, los campos opcionales y el formato de respuesta. Esto es útil para construir scripts de automatización.

Paso 5: Llama a las herramientas desde el CLI

Ejecuta las herramientas de CrawlForge directamente desde tu terminal:

// Equivalent to calling from TypeScript:
// await crawlforge.extractContent({ url: 'https://docs.stripe.com/api' })

// From the Smithery CLI:
// smithery tool call crawlforge extract_content '{"url": "https://docs.stripe.com/api"}'

# Extract clean text from a documentation page (1 credit)
smithery tool call crawlforge extract_text \
  '{"url": "https://docs.stripe.com/api"}'

# Search the web for competitive intelligence (5 credits)
smithery tool call crawlforge search_web \
  '{"query": "best web scraping tools 2026", "limit": 10}'

# Extract structured data with CSS selectors (2 credits)
smithery tool call crawlforge scrape_structured \
  '{"url": "https://news.ycombinator.com", "selectors": {"titles": ".titleline > a", "scores": ".score"}}'

Cuando se canaliza la salida, Smithery genera JSONL, que se integra limpiamente con jq y otras herramientas de CLI:

smithery tool call crawlforge search_web \
  '{"query": "TypeScript MCP server"}' | jq '.results[].title'

Paso 6: Usa namespaces para los entornos

Los namespaces de Smithery te permiten aislar las conexiones de CrawlForge entre los entornos de desarrollo, staging y producción:

# Create environment-specific namespaces
smithery namespace create myapp-dev
smithery namespace create myapp-prod

# Switch to dev namespace and add CrawlForge with test API key
smithery namespace use myapp-dev
smithery mcp add "https://crawlforge.run.tools" \
  --id crawlforge \
  --metadata '{"apiKey": "cf_test_dev_key"}'

# Switch to prod namespace with production API key
smithery namespace use myapp-prod
smithery mcp add "https://crawlforge.run.tools" \
  --id crawlforge \
  --metadata '{"apiKey": "cf_live_prod_key"}'

Esto evita el consumo accidental de credits en tu cuenta de producción durante el desarrollo.

Referencia de costes en credits

El plan gratuito incluye 1.000 credits. Un flujo de investigación típico -- búsqueda (5) + extracción de 3 páginas (6) + resumen (2) -- cuesta 13 credits en total.

Cuándo usar Smithery frente a la instalación directa

Si ya usas Smithery para otros MCP servers (GitHub, Slack, Notion), añadir CrawlForge a través de Smithery mantiene todo en una sola capa de gestión. Si CrawlForge es tu único MCP server, la instalación directa es más sencilla.

Próximos pasos

• Inicio rápido de CrawlForge -- guía de instalación directa para Claude Code
• Resumen de 18 herramientas de web scraping -- qué hace cada herramienta y cuándo usarla
• Ver precios -- packs de credits y planes de suscripción
• Documentación de Smithery -- referencia completa del CLI de Smithery

¿Listo para empezar a hacer scraping? Regístrate gratis y obtén 1.000 credits, sin necesidad de tarjeta de crédito. Luego instala vía Smithery o npm y empieza a extraer datos web en menos de 60 segundos.