CrawlForge MCP Referencia de la API

https://crawlforge.dev/api/v1

curl -H "X-API-Key: cf_test_YOUR_KEY" \
     https://crawlforge.dev/api/v1/tools/fetch_url

Obtenga su API key desde el panel.

{
  "url": "https://example.com",
  "timeout": 10000,
  "follow_redirects": true
}

{
  "success": true,
  "data": {
    // Tool-specific response data
  },
  "credits_used": 1,
  "credits_remaining": 999,
  "processing_time": 245
}

Una respuesta también puede incluir un array opcional de cadenas warnings en el nivel superior, junto a data y credits_used, no dentro de data. Solo aparece cuando una solicitud ha generado un aviso: usted desactivó la comprobación de robots.txt con respect_robots: false —lo que además queda registrado en su API key— o una herramienta multi-URL omitió una URL o no descargó una fuente. Si nunca desactiva la comprobación y todas las URLs que solicita están permitidas, ninguna respuesta incluirá el campo; su ausencia es lo normal, no un valor que falte.

Los SDK oficiales, crawlforge-sdk en npm y crawlforge en PyPI, exponen un método tipado por herramienta que acepta los mismos parámetros que el endpoint REST. Las pestañas de TypeScript y Python de cada página de herramienta los utilizan.

// npm install crawlforge-sdk
import { CrawlForge } from 'crawlforge-sdk';

const client = new CrawlForge({ apiKey: process.env.CRAWLFORGE_API_KEY });

const result = await client.fetchUrl({ url: 'https://example.com' });
console.log('Credits remaining:', result.creditsRemaining);

Toda la API REST está descrita en un documento OpenAPI 3.1 disponible en https://www.crawlforge.dev/openapi.json, generado a partir de los mismos esquemas que validan cada solicitud, de modo que un generador de código o un cliente de API pueden apuntar directamente a él.

curl -s https://www.crawlforge.dev/openapi.json | jq '.paths | keys'

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid input parameters",
    "details": [
      {
        "field": "url",
        "message": "Invalid URL format"
      }
    ]
  }
}

Consulte las preguntas frecuentes para ver una lista completa de códigos de error y soluciones.