Cara Menggunakan CrawlForge dengan Windsurf IDE

Windsurf ialah editor kod AI generasi baharu yang dibina oleh Codeium, direka berasaskan konsep "Flows" -- tindakan AI pelbagai langkah yang memahami keseluruhan pangkalan kod anda (lihat dokumen permulaan rasmi Windsurf). CrawlForge MCP melanjutkan keupayaan Windsurf melangkaui fail tempatan anda dan ke web langsung dengan memasang ke dalam sokongan MCP Cascade, membolehkan AI mengambil dokumentasi, melakukan scraping pada pelaksanaan rujukan, menyelidik API, dan mengekstrak data -- semuanya dari dalam editor anda.

Panduan ini menunjukkan kepada anda cara mengkonfigurasi CrawlForge sebagai MCP server dalam Windsurf dan menggunakannya untuk tugas pembangunan sebenar.

Jadual Kandungan

• Prasyarat
• Mengapa CrawlForge dalam Windsurf
• Langkah 1: Pasang CrawlForge MCP Server
• Langkah 2: Konfigurasi Tetapan MCP Windsurf
• Langkah 3: Sahkan Sambungan
• Kes Penggunaan Praktikal
• Pecahan Kos Credit
• Penyelesaian Masalah
• Langkah Seterusnya

Prasyarat

• Windsurf IDE dipasang (windsurf.com)
• Node.js 18+ dipasang
• Sebuah API key CrawlForge -- daftar percuma untuk 1,000 credits

Mengapa CrawlForge dalam Windsurf

Ejen AI Cascade Windsurf sudah boleh membaca pangkalan kod anda dan membuat suntingan pelbagai fail. Tetapi ia tidak boleh mengakses sumber luaran:

• Ia tidak boleh membaca dokumentasi API terkini untuk pustaka yang anda gunakan
• Ia tidak boleh menyemak cara pesaing melaksanakan ciri tertentu
• Ia tidak boleh menarik HTML dunia sebenar untuk menguji penghurai anda
• Ia tidak boleh menyelidik amalan terbaik merentas pelbagai sumber

CrawlForge menyelesaikan masalah ini. Setelah dikonfigurasi, ejen AI Windsurf memperoleh akses kepada kesemua 26 tools CrawlForge -- dan memilih yang betul berdasarkan apa yang anda minta.

Langkah 1: Pasang CrawlForge MCP Server

Buka terminal anda dan pasang CrawlForge MCP server secara global:

npm install -g crawlforge-mcp-server

Sahkan pemasangan:

crawlforge-mcp-server --version

Langkah 2: Konfigurasi Tetapan MCP Windsurf

Windsurf membaca konfigurasi MCP server daripada fail JSON. Buka konfigurasi MCP Windsurf anda:

macOS / Linux:

# Open or create the MCP config
code ~/.windsurf/mcp_config.json

Windows:

code %APPDATA%\Windsurf\mcp_config.json

Tambah server CrawlForge ke objek mcpServers:

// ~/.windsurf/mcp_config.json
{
  "mcpServers": {
    "crawlforge": {
      "command": "crawlforge-mcp-server",
      "args": [],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      }
    }
  }
}

Gantikan cf_live_your_api_key_here dengan API key sebenar anda daripada papan pemuka CrawlForge.

Alternatif: Konfigurasi Peringkat Projek

Untuk projek pasukan, cipta .windsurf/mcp_config.json dalam root projek anda. Ini memastikan konfigurasi dikawal versi (tetapi ingat untuk menambah API key anda melalui pemboleh ubah persekitaran dan bukannya mengekodkannya secara keras):

// .windsurf/mcp_config.json
{
  "mcpServers": {
    "crawlforge": {
      "command": "crawlforge-mcp-server",
      "args": [],
      "env": {
        "CRAWLFORGE_API_KEY": "${CRAWLFORGE_API_KEY}"
      }
    }
  }
}

Langkah 3: Sahkan Sambungan

Mulakan semula Windsurf untuk mengambil konfigurasi MCP yang baharu. Kemudian buka panel Cascade (Cmd+L / Ctrl+L) dan taip:

Windsurf sepatutnya memanggil tool fetch_url atau extract_content CrawlForge secara automatik dan memulangkan ringkasan. Jika anda melihat hasilnya, sambungan sedang berfungsi.

Anda boleh mengesahkan tools yang tersedia dengan bertanya:

Cascade akan menyenaraikan kesemua 26 tools dengan penerangannya.

Kes Penggunaan Praktikal

Fetch Dokumentasi Semasa Mengekod

Minta Cascade membaca dokumen terkini untuk mana-mana pustaka:

Tool extract_content CrawlForge mengambil halaman dokumentasi, dan Cascade menerapkannya terus pada kod anda. Kos: 2 credits.

Selidik Corak Reka Bentuk API

Cascade menggunakan search_web untuk mencari artikel, kemudian extract_content untuk membacanya. Kos: ~11 credits (5 untuk carian + 2 setiap halaman untuk 3 halaman).

Jana Data Ujian daripada Laman Web Sebenar

Tool scrape_structured CrawlForge mengekstrak data, dan Cascade menjana antara muka bertaip daripada respons. Kos: 2 credits.

Pantau Changelog Pesaing

Menggunakan extract_content untuk membaca halaman dan menapis mengikut tarikh. Kos: 2 credits.

Pecahan Kos Credit

Sesi pembangunan biasa menggunakan 10-30 credits. Pelan Free (1,000 credits sekali sahaja) meliputi kebanyakan keperluan awal pembangun.

Penyelesaian Masalah

"MCP server not found": Sahkan laluan pemasangan global berada dalam PATH sistem anda. Jalankan which crawlforge-mcp-server untuk menyemak. Jika ia tidak memulangkan apa-apa, pasang semula dengan npm install -g crawlforge-mcp-server.

"Authentication failed": Semak semula API key anda dalam mcp_config.json. Key bermula dengan cf_live_ untuk pengeluaran atau cf_test_ untuk pembangunan.

Tools tidak muncul: Mulakan semula Windsurf selepas menyunting konfigurasi MCP. Server dimuatkan semasa permulaan IDE.

Respons perlahan: Tools CrawlForge yang memaparkan JavaScript (scrape_with_actions, stealth_mode) mengambil masa 3-8 saat. Tools statik seperti fetch_url dan extract_text memberi respons dalam masa kurang 1 saat.

Langkah Seterusnya

Dengan CrawlForge dikonfigurasi dalam Windsurf, terokai aliran kerja ini:

• Gunakan stealth mode untuk mengakses laman dengan perlindungan anti-bot
• Bina aliran kerja ejen penyelidikan untuk analisis pasaran
• Terokai Mula Pantas CrawlForge yang lengkap untuk pilihan konfigurasi MCP
• Semak kesemua 26 tools dan keupayaannya

Beri editor AI anda akses kepada web langsung. Mulakan secara percuma dengan 1,000 credits -- tiada kad kredit diperlukan.