Gemini CLI

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

Gemini CLI

Pasang dari geminicli.com

Diperlukan

Node.js 18+

Pasang dari nodejs.org

Diperlukan

API Key

Dapatkan dari dashboard

Free

Dapatkan API Key CrawlForge

Konfigurasi di bawah memulakan pelayan melalui 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.

Bash

npm install -g crawlforge-mcp-server
crawlforge login        # opens the browser approval page

Atau salin kunci daripada dashboard dan tampalkannya ke dalam konfigurasi pada langkah seterusnya.

Petua: Panduan CLI merangkumi crawlforge login dan cara pengesahan yang lain.

Daftarkan Pelayan dengan Gemini CLI

Pilih kaedah konfigurasi pilihan anda:

APilihan A: Satu arahan, skop pengguna

Jalankan sekali dan CrawlForge tersedia dalam setiap projek:

Bash

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):

~/.gemini/settings.jsonJson

{
  "mcpServers": {
    "crawlforge": {
      "command": "npx",
      "args": [
        "-y",
        "crawlforge-mcp-server@latest",
        "mcp"
      ],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      }
    }
  }
}

Petua: .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.

Tetapkan API Key Anda

Gantikan cf_live_your_api_key_here dengan kunci anda, atau biarkan konfigurator mengisinya.

Jana konfigurasi ini dengan kunci anda: 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:

Json

"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.

Keselamatan: Jangan sekali-kali commit API key anda ke kawalan versi. Gunakan pemboleh ubah persekitaran atau fail konfigurasi.

Uji Penyepaduan

Mulakan sesi Gemini CLI baharu dan sahkan pelayan telah bersambung.

Bash

gemini mcp list

Semak status — gemini mcp list menunjukkan pelayan yang dikonfigurasi; /mcp di dalam sesi menyenaraikannya bersama alat mereka
Mulakan semula jika perlu — mulakan sesi gemini baharu 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.json ialah JSON yang sah
Pastikan Node.js 18+ dipasang: node --version
Jalankan gemini mcp list untuk melihat skop tempat pelayan ditulis
Mulakan sesi Gemini CLI baharu

Ralat Pengesahan?

Semak API key bermula dengan cf_live_
Jalankan crawlforge login untuk menyimpan kunci baharu
Jana API key baharu daripada dashboard

Alat tidak dipanggil?

Jalankan /mcp dan sahkan alat crawlforge disenaraikan
Minta hasil yang konkrit ("scrape halaman ini") supaya model memilih alat
Kecilkan senarai alat dengan CRAWLFORGE_TOOL_GROUPS jika model mempunyai terlalu banyak alat untuk dipilih

Masih menghadapi isu? 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.

Lihat Semua Alat Panduan Pengoptimuman Credit

{ "mcpServers": { "crawlforge": { "command": "npx", "args": [ "-y", "crawlforge-mcp-server@latest", "mcp" ], "env": { "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here" } } } }