Langkau ke kandungan
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

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

2
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"
      }
    }
  }
}
3
Tetapkan API Key Anda
Gantikan cf_live_your_api_key_here dengan kunci anda, atau biarkan konfigurator mengisinya.

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.

4
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`?

  1. Semak ~/.gemini/settings.json ialah JSON yang sah
  2. Pastikan Node.js 18+ dipasang: node --version
  3. Jalankan gemini mcp list untuk melihat skop tempat pelayan ditulis
  4. Mulakan sesi Gemini CLI baharu

Ralat Pengesahan?

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

Alat tidak dipanggil?

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

Berjaya disepadukan?

Terokai semua alat yang tersedia dan kawal perbelanjaan credit anda.