API Penyelidikan Pasaran untuk Agensi: Satu Persediaan, Setiap Klien

Masalah penyelidikan sebuah agensi jarang sekali satu soalan yang sukar. Ia soalan yang sama, untuk setiap klien, setiap bulan, ditambah gambaran pasaran baharu setiap kali pasukan perniagaan baharu mahukan dek pitch sebelum Khamis.

Sebuah API penyelidikan pasaran untuk agensi perlu dibina untuk ulangan itu: satu persediaan yang menjalankan seluruh senarai klien, kos yang boleh dipecahkan mengikut klien, dan semakan pertama yang pantas ke atas prospek yang belum anda menangi. CrawlForge ialah lapisan web untuk tugas itu. Ia membaca halaman awam dan hasil carian yang anda tunjukkan dan memulangkan apa yang tertulis di situ. Ia bukan pangkalan data saiz pasaran atau kenalan.

Apakah yang diperlukan oleh laporan bulanan klien?

Bagi kebanyakan agensi, dua perkara untuk setiap klien: kedudukan carian klien berbanding pesaingnya untuk carian yang penting, dan apa yang diubah oleh pesaing itu di laman web mereka sendiri. Kedua-duanya awam, kedua-duanya berubah setiap bulan, dan kedua-duanya tiada dalam mana-mana set data yang boleh dilesenkan mengikut baris.

Dua panggilan sudah memadai:

• serp_rank (5 credits) memulangkan kedudukan organik Google sesuatu domain bagi satu kata kunci, disemak dari location_name, language_code dan device yang anda tetapkan untuk setiap klien. Respons mengandungi found, rank, url yang berada di kedudukan itu dan checked_at.
• scrape dengan format question (3 credits) memulangkan, kata demi kata, lima ayat di halaman pesaing yang paling baik menjawab soalan anda, setiap satu dengan offset. Catatan untuk RevOps menerangkan cara format itu berfungsi; di sini ia hanya satu baris dalam templat.

Bagaimana anda menjalankan satu templat untuk setiap klien?

Simpan semua yang khusus untuk klien dalam data, bukan dalam kod. Setiap klien ialah satu konfigurasi kecil: domainnya, pasarannya, kata kuncinya, pesaingnya dan soalan yang anda tanyakan kepada halaman mereka.

{
  "client": "Northwind",
  "domain": "northwind.co.uk",
  "location_name": "United Kingdom",
  "device": "mobile",
  "keywords": ["office cleaning contracts", "commercial cleaning manchester"],
  "competitors": ["rival-a.co.uk", "rival-b.co.uk", "rival-c.co.uk"],
  "pages": ["https://rival-a.co.uk/pricing", "https://rival-b.co.uk/services"],
  "questions": ["What is the minimum contract length?"]
}

Kemudian satu aliran kerja meneliti seluruh senarai klien. Bagi setiap kata kunci, ia memanggil serp_rank sekali untuk klien dan sekali untuk setiap pesaing, kerana setiap panggilan hanya mencari satu domain. Bagi setiap halaman pesaing, ia menjalankan satu scrape bagi setiap soalan.

curl -X POST https://crawlforge.dev/api/v1/tools/serp_rank \
  -H "X-API-Key: cf_live_NORTHWIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyword": "office cleaning contracts",
    "target": "northwind.co.uk",
    "location_name": "United Kingdom",
    "device": "mobile"
  }'

Dalam n8n, gelung itu ialah satu nod yang membaca konfigurasi dan menyuap dua nod HTTP Request (persediaan n8n ada dalam dokumentasi); dalam skrip, ia dua gelung bersarang. Klien ketiga belas hanyalah fail konfigurasi baharu, bukan aliran kerja baharu.

Berikan setiap klien kunci API bernama sendiri dan log permintaan akan memecahkan perbelanjaan bulan itu mengikut klien, seperti yang diterangkan langkah demi langkah dalam catatan untuk perunding. Satu akaun memuatkan sepuluh kunci, jadi selepas sepuluh klien, kumpulkan mereka mengikut retainer.

Bagaimana anda menyelidik prospek sebelum pitch?

Mulakan dengan satu larian deep_research untuk 10 credits. Berikan kategori dan pasaran prospek; ia mencari, mengambil sehingga sepuluh sumber dan memulangkan petikan yang paling sepadan kata demi kata, bersama senarai sources berisi URL. Kemudian jalankan serp_rank pada tiga kata kunci paling jelas bagi prospek itu untuk 15 credits lagi.

Itu 25 credits bagi setiap prospek, kurang daripada sepuluh sen AS pada harga pek, dan ia meletakkan slaid "kedudukan anda hari ini" dalam dek. Slaid itu biasanya membuka perbualan, dan kosnya hampir tiada apabila pitch tidak berjaya.

Berapakah kos satu senarai klien setiap bulan?

Dua belas klien, setiap satu dengan lima kata kunci, tiga pesaing, enam halaman pesaing dan dua soalan bagi setiap halaman:

Itu kira-kira $5 sebulan pada harga pek sekali beli 5,000 credits ($14), tanpa yuran setiap pengguna dan tanpa minimum bulanan. Semakan kedudukan ialah baris yang paling mahal kerana ia mendarabkan kata kunci dengan domain, jadi kurangkan pesaing daripada gelung kedudukan sebelum anda mengurangkan kata kunci.

Apa yang ia tidak akan lakukan?

• Tiada anggaran saiz pasaran. Tiada TAM, panel atau data tinjauan. Jika dek memerlukan angka saiz pasaran, ia datang daripada laporan.
• Tiada data kenalan atau firmografik. Ia membaca halaman dan hasil carian. Ia bukan pangkalan data syarikat.
• Tiada portal untuk klien. Tiada papan pemuka label putih; laporan ialah apa sahaja yang anda bina daripada baris-baris itu.
• robots.txt dihormati secara lalai pada halaman yang anda scrape. Halaman yang tidak dibenarkan ditolak sebelum diambil dan tidak dikenakan bayaran.

Jika klien mahu tahu bila halaman pesaing berubah, bukannya membacanya pada hujung bulan, itu ialah satu monitor bagi setiap klien, bukan larian yang lebih kerap untuk templat ini.

Mulakan secara percuma dengan 1,000 credits. Itu cukup untuk menjalankan templat ini bagi tujuh klien selama sebulan sebelum anda menyambungkannya ke seluruh senarai klien.