Cara Menggunakan CrawlForge dengan Smithery: Panduan Registri MCP

Smithery ialah registri MCP server terbesar, menghoskan lebih 100,000 alat dan integrasi untuk agen AI. CrawlForge disenaraikan di Smithery, yang bermaksud anda boleh menemui, memasang, dan menguruskan MCP server web scraping anda tanpa menyentuh fail konfigurasi secara manual.

Panduan ini membimbing anda melalui aliran kerja Smithery yang lengkap -- daripada mencari registri sehingga memanggil alat CrawlForge dalam pengeluaran.

Kandungan

• Apakah itu Smithery?
• Prasyarat
• Langkah 1: Pasang Smithery CLI
• Langkah 2: Cari CrawlForge di Smithery
• Langkah 3: Sambung ke CrawlForge
• Langkah 4: Layari Alat yang Tersedia
• Langkah 5: Panggil Alat dari CLI
• Langkah 6: Gunakan Namespace untuk Persekitaran
• Rujukan Kos Credit
• Bila Hendak Menggunakan Smithery lwn Pemasangan Langsung
• Langkah Seterusnya

Apakah itu Smithery?

Smithery ialah pasaran dan registri untuk MCP server. Anggap ia sebagai npm untuk alat agen AI. Daripada mengkonfigurasi setiap MCP server secara manual dalam fail tetapan klien anda, Smithery menyediakan CLI dan antara muka web untuk mencari, memasang, dan menguruskan sambungan MCP.

Smithery mengendalikan aliran OAuth, penyimpanan kelayakan, penyegaran token, dan kitaran hayat sesi secara automatik. Untuk pasukan yang menjalankan berbilang MCP server merentas persekitaran dev dan pengeluaran, ini menghapuskan overhed konfigurasi yang ketara.

Prasyarat

• Node.js 18+ dipasang
• Akaun CrawlForge dengan API key (free tier termasuk 1,000 credits)
• Akses terminal (macOS, Linux, atau Windows dengan WSL)

Langkah 1: Pasang Smithery CLI

npm install -g @smithery/cli

Sahkan dengan akaun Smithery anda:

smithery auth login

Ini membuka pelayar anda untuk pengesahan. Setelah disahkan, CLI menyimpan kelayakan anda secara setempat.

Langkah 2: Cari CrawlForge di Smithery

Cari registri Smithery untuk CrawlForge:

smithery mcp search "crawlforge"

Anda akan melihat CrawlForge disenaraikan dengan deskripsinya, kiraan alat (31 alat), dan URL sambungan. Anda juga boleh melayari katalog web Smithery untuk membaca ulasan dan dokumentasi sebelum memasang.

Langkah 3: Sambung ke CrawlForge

Tambah CrawlForge sebagai sambungan MCP terurus:

smithery mcp add "https://crawlforge.run.tools" \
  --id crawlforge \
  --metadata '{"apiKey": "cf_live_your_key_here"}'

Sahkan status sambungan:

smithery mcp list

Anda sepatutnya melihat crawlforge dengan status connected. Jika ia menunjukkan auth_required, ikuti URL kebenaran yang disediakan dalam output.

Langkah 4: Layari Alat yang Tersedia

Senaraikan kesemua 31 alat CrawlForge melalui Smithery:

# List all tool groups
smithery tool list crawlforge

# Drill into extraction tools
smithery tool list crawlforge extract.

# Inspect a specific tool's input/output schema
smithery tool get crawlforge extract_content

Arahan tool get menunjukkan JSON schema penuh untuk setiap alat, termasuk parameter yang diperlukan, medan pilihan, dan format respons. Ini berguna untuk membina skrip automasi.

Langkah 5: Panggil Alat dari CLI

Laksanakan alat CrawlForge terus dari terminal anda:

// Equivalent REST call:
// POST https://crawlforge.dev/api/v1/tools/extract_content
// with body {"url": "https://docs.stripe.com/api"}

// From the Smithery CLI:
// smithery tool call crawlforge extract_content '{"url": "https://docs.stripe.com/api"}'

# Extract clean text from a documentation page (1 credit)
smithery tool call crawlforge extract_text \
  '{"url": "https://docs.stripe.com/api"}'

# Search the web for competitive intelligence (5 credits)
smithery tool call crawlforge search_web \
  '{"query": "best web scraping tools 2026", "limit": 10}'

# Extract structured data with CSS selectors (2 credits)
smithery tool call crawlforge scrape_structured \
  '{"url": "https://news.ycombinator.com", "selectors": {"titles": ".titleline > a", "scores": ".score"}}'

Apabila disalurkan, Smithery mengeluarkan JSONL, yang berintegrasi dengan kemas dengan jq dan alat CLI lain:

smithery tool call crawlforge search_web \
  '{"query": "TypeScript MCP server"}' | jq '.results[].title'

Langkah 6: Gunakan Namespace untuk Persekitaran

Namespace Smithery membenarkan anda mengasingkan sambungan CrawlForge merentas dev, pementasan, dan pengeluaran:

# Create environment-specific namespaces
smithery namespace create myapp-dev
smithery namespace create myapp-prod

# Switch to dev namespace and add CrawlForge with test API key
smithery namespace use myapp-dev
smithery mcp add "https://crawlforge.run.tools" \
  --id crawlforge \
  --metadata '{"apiKey": "cf_test_dev_key"}'

# Switch to prod namespace with production API key
smithery namespace use myapp-prod
smithery mcp add "https://crawlforge.run.tools" \
  --id crawlforge \
  --metadata '{"apiKey": "cf_live_prod_key"}'

Ini menghalang penggunaan credit yang tidak disengajakan pada akaun pengeluaran anda semasa pembangunan.

Rujukan Kos Credit

Free tier termasuk 1,000 credits. Aliran kerja penyelidikan biasa -- carian (5) + ekstrak 3 halaman (6) + ringkaskan (2) -- berharga 13 credits secara keseluruhan.

Bila Hendak Menggunakan Smithery lwn Pemasangan Langsung

Jika anda sudah menggunakan Smithery untuk MCP server lain (GitHub, Slack, Notion), menambah CrawlForge melalui Smithery memastikan semuanya berada dalam satu lapisan pengurusan. Jika CrawlForge ialah satu-satunya MCP server anda, pemasangan langsung adalah lebih mudah.

Langkah Seterusnya

• CrawlForge Quick Start -- panduan pemasangan langsung untuk Claude Code
• Gambaran Keseluruhan 31 Alat Web Scraping -- apa yang dilakukan oleh setiap alat dan bila hendak menggunakannya
• Lihat Harga -- pek credit dan plan langganan
• Dokumentasi Smithery -- rujukan Smithery CLI penuh

Bersedia untuk mula scraping? Daftar percuma dan dapatkan 1,000 credits -- tanpa memerlukan kad kredit. Kemudian pasang melalui Smithery atau npm dan mula mengekstrak data web dalam masa kurang daripada 60 saat.