Penyepaduan Gemini CLI
Beri Gemini CLI akses web langsung dengan CrawlForge MCP. Satu arahan gemini mcp add mendaftarkan pelayan dalam ~/.gemini/settings.json, atau tambah blok mcpServers sendiri.
Prasyarat
npx, jadi tiada pemasangan global diperlukan—hanya satu kunci.Log masuk dari terminal: CLI membuka halaman pelayar tempat anda meluluskan kunci baharu, kemudian menyimpannya ke ~/.crawlforge/config.json.
npm install -g crawlforge-mcp-server
crawlforge login # opens the browser approval pageAtau salin kunci daripada dashboard dan tampalkannya ke dalam konfigurasi pada langkah seterusnya.
Panduan CLI merangkumi crawlforge login dan cara pengesahan yang lain.
APilihan A: Satu arahan, skop pengguna
Jalankan sekali dan CrawlForge tersedia dalam setiap projek:
gemini mcp add -s user -e CRAWLFORGE_API_KEY=cf_live_your_api_key_here crawlforge npx -- -y crawlforge-mcp-server@latest mcp-s user menulis ke ~/.gemini/settings.json; -s project menulis ke .gemini/settings.json dalam repo semasa sebaliknya.
BPilihan B: Edit settings.json
Tambah blok mcpServers ke ~/.gemini/settings.json (atau .gemini/settings.json dalam projek):
{
"mcpServers": {
"crawlforge": {
"command": "npx",
"args": [
"-y",
"crawlforge-mcp-server@latest",
"mcp"
],
"env": {
"CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
}
}
}
}.gemini/settings.json projek boleh di-commit supaya seluruh pasukan mendapat pelayan; jika anda berbuat demikian, tinggalkan kunci dan biarkan setiap pembangun menambah kunci mereka sendiri.
cf_live_your_api_key_here dengan kunci anda, atau biarkan konfigurator mengisinya.Konfigurator MCP mengisi kunci anda dan mengeluarkan arahan serta JSON yang tepat untuk Gemini CLI.
Hadkan senarai alat (pilihan)
CrawlForge menyediakan 31 alat. Tetapkan CRAWLFORGE_TOOL_GROUPS dalam blok env yang sama untuk memuatkan hanya kumpulan yang anda perlukan, contohnya basic,search:
"env": {
"CRAWLFORGE_API_KEY": "cf_live_your_api_key_here",
"CRAWLFORGE_TOOL_GROUPS": "basic,search"
}Kumpulan: basic, search, crawl, extract, batch, research, tracking, llmstxt, stealth, templates, scrape, agent.
Jangan sekali-kali commit API key anda ke kawalan versi. Gunakan pemboleh ubah persekitaran atau fail konfigurasi.
gemini mcp list- Semak status —
gemini mcp listmenunjukkan pelayan yang dikonfigurasi;/mcpdi dalam sesi menyenaraikannya bersama alat mereka - Mulakan semula jika perlu — mulakan sesi
geminibaharu selepas mengedit tetapan - Uji satu gesaan — cuba salah satu contoh di bawah; Gemini memilih alat CrawlForge sendiri
Contoh Gesaan
"Search for the latest AI news"
"Extract all links from example.com"
"Crawl the documentation site and summarize it"
"Extract product prices from this e-commerce site"
Lihat rujukan API penuh untuk kesemua 31 alat dan parameter mereka.
Penyelesaian Masalah
Pelayan tiada dalam `/mcp`?
- Semak
~/.gemini/settings.jsonialah JSON yang sah - Pastikan Node.js 18+ dipasang:
node --version - Jalankan
gemini mcp listuntuk melihat skop tempat pelayan ditulis - Mulakan sesi Gemini CLI baharu
Ralat Pengesahan?
- Semak API key bermula dengan
cf_live_ - Jalankan
crawlforge loginuntuk menyimpan kunci baharu - Jana API key baharu daripada dashboard
Alat tidak dipanggil?
- Jalankan
/mcpdan sahkan alat crawlforge disenaraikan - Minta hasil yang konkrit ("scrape halaman ini") supaya model memilih alat
- Kecilkan senarai alat dengan
CRAWLFORGE_TOOL_GROUPSjika model mempunyai terlalu banyak alat untuk dipilih
Hubungi simon@crawlforge.dev dengan versi Gemini CLI, versi Node.js dan output gemini mcp list anda.
Berjaya disepadukan?
Terokai semua alat yang tersedia dan kawal perbelanjaan credit anda.