CrawlForge MCP Rujukan API

https://crawlforge.dev/api/v1

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

Dapatkan kunci API anda daripada papan pemuka.

{
  "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
}

Respons juga boleh membawa tatasusunan rentetan warnings pilihan di aras atas, bersebelahan data dan credits_used dan bukan di dalam data. Ia hadir hanya apabila sesuatu permintaan menghasilkan amaran: anda mematikan semakan robots.txt dengan respect_robots: false — yang turut direkodkan pada kunci API anda — atau sesuatu alat berbilang URL melangkau satu URL atau tidak mengambil sesuatu sumber. Jika anda tidak pernah mematikan semakan itu dan setiap URL yang anda minta dibenarkan, tiada respons akan membawa medan tersebut; ketiadaannya adalah keadaan biasa, bukan nilai yang hilang.

SDK rasmi, crawlforge-sdk di npm dan crawlforge di PyPI, mendedahkan satu kaedah bertaip bagi setiap alat yang menerima parameter yang sama seperti titik akhir REST. Tab TypeScript dan Python pada setiap halaman alat menggunakannya.

// 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);

Keseluruhan API REST diterangkan oleh sebuah dokumen OpenAPI 3.1 di https://www.crawlforge.dev/openapi.json, yang dijana daripada skema yang sama yang mengesahkan setiap permintaan, jadi penjana kod atau klien API boleh dihalakan terus kepadanya.

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"
      }
    ]
  }
}

Lihat FAQ untuk senarai lengkap kod ralat dan penyelesaian.