Pearch

Pearch.ai MCP

เซิร์ฟเวอร์ MCP สำหรับ Pearch.AI: การค้นหาด้วยภาษาธรรมชาติสำหรับบุคคลและบริษัท/ลีด (B2B) ใช้ได้จาก Claude, Cursor, VS Code หรือไคลเอนต์ที่รองรับ MCP ใดก็ได้

การประเมินเครื่องมือจัดหาแหล่งผู้สมัครงานด้วย AI โดยความชอบของมนุษย์

เครื่องมือ

เครื่องมือ	คำอธิบาย
search_people	ค้นหาบุคคลด้วยภาษาธรรมชาติ (เช่น "วิศวกรซอฟต์แวร์ในแคลิฟอร์เนียที่มีประสบการณ์ Python 5 ปีขึ้นไป") รองรับประเภทการค้นหาแบบ fast/pro/superfast, การเปิดเผยข้อมูลติดต่อและตัวกรองข้อมูลติดต่อ, การรีเฟรชโปรไฟล์แบบเรียลไทม์, ข้อมูลเชิงลึก และการแบ่งหน้า/การติดตามผลแบบเธรด
search_company_leads	ค้นหาบริษัทและลีด/ผู้ติดต่อภายในบริษัทเหล่านั้น (B2B) ตัวอย่าง: บริษัท "สตาร์ทอัพ AI ในซานฟรานซิสโก พนักงาน 50–200 คน" + ลีด "CTO และผู้จัดการฝ่ายวิศวกรรม" พร้อมข้อความติดต่อส่วนตัวแบบไม่บังคับ
get_profile	ค้นหาและเพิ่มข้อมูลบุคคลเดียวโดยใช้ LinkedIn slug หรืออีเมล (เปิดเผยข้อมูลติดต่อ, รีเฟรชแบบเรียลไทม์, เพิ่มข้อมูลจาก GitHub)
get_user_info	ข้อมูลผู้ใช้ที่ผ่านการยืนยันตัวตน: อีเมล, เครดิตคงเหลือ, แผนการคิดค่าบริการ ฟรี

ตัวกรองโครงสร้างแบบกำหนดเอง (custom_filters / search_requirements) ถูกตั้งใจไม่ให้แสดง — อธิบายทุกอย่างในคำค้นหาภาษาธรรมชาติ

เซิร์ฟเวอร์ระยะไกล (แนะนำ)

เซิร์ฟเวอร์ที่โฮสต์อยู่ที่ https://mcp.pearch.ai/mcp และรองรับรูปแบบการยืนยันตัวตนสองแบบพร้อมกัน:

OAuth (ไม่ต้องจัดการคีย์)

เพิ่มเซิร์ฟเวอร์โดยไม่มีส่วนหัวใด ๆ — ไคลเอนต์ที่รองรับ OAuth (Claude, Cursor, VS Code) จะค้นพบขั้นตอนโดยอัตโนมัติและเปิดการเข้าสู่ระบบด้วย Google ลงชื่อเข้าด้วยบัญชี Google ที่อีเมลตรงกับบัญชี Pearch ของคุณ:

claude mcp add --transport http pearch https://mcp.pearch.ai/mcp

การค้นหาของคุณจะหักเครดิตจากบัญชี Pearch ของคุณเอง หากบัญชี Pearch ของคุณยังไม่มีคีย์ API ให้สร้างก่อนใน แดชบอร์ด Pearch.ai

คีย์ API

ส่งคีย์ API Pearch เดียวกันเป็น api.pearch.ai:

{
  "mcpServers": {
    "Pearch.ai": {
      "url": "https://mcp.pearch.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PEARCH_API_KEY}"
      }
    }
  }
}

ใช้ test_mcp_key สำหรับผลลัพธ์ (ตัวอย่าง) ที่ถูกปกปิด — ไม่ต้องสมัครสมาชิก

การติดตั้งในเครื่อง (stdio)

ต้องใช้ Python 3.10+ และ pip install -r requirements.txt (หรือ pip install fastmcp)

Claude Desktop / Claude Code

fastmcp install claude-desktop pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key

หรือด้วยตนเองภายใต้ mcpServers:

"Pearch.ai": {
  "command": "python",
  "args": ["/path/to/mcp_pearch/pearch_mcp.py"],
  "env": { "PEARCH_API_KEY": "test_mcp_key" }
}

Cursor

fastmcp install cursor pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key

แทนที่ test_mcp_key ด้วยคีย์แดชบอร์ดของคุณเพื่อผลลัพธ์เต็มรูปแบบ

การรันเซิร์ฟเวอร์ HTTP ของคุณเอง

uvicorn pearch_mcp:app --host 0.0.0.0 --port 8000

การตรวจสอบสุขภาพ: GET /health หรือ /healthcheck (รายงานโหมดการยืนยันตัวตน)

ตัวแปรสภาพแวดล้อม

ตัวแปร	ค่าเริ่มต้น	วัตถุประสงค์
PEARCH_MCP_AUTH	api_key	oauth | api_key | none ในโหมด oauth ผู้ถือคีย์ API ดิบยังคงได้รับการยอมรับ (การยืนยันตัวตนแบบคู่)
PEARCH_MCP_BASE_URL	http://localhost:8000	URL สาธารณะของเซิร์ฟเวอร์นี้ ข้อมูลเมตา OAuth, กลุ่มเป้าหมายของโทเค็น และ URI เปลี่ยนเส้นทาง /auth/callback ทั้งหมดได้มาจากสิ่งนี้
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET	—	ไคลเอนต์แอปพลิเคชันเว็บ Google OAuth 2.0 (ลงทะเบียน <base_url>/auth/callback เป็น URI เปลี่ยนเส้นทาง) จำเป็นในโหมด oauth
PEARCH_MCP_INTERNAL_TOKEN	—	ความลับที่ใช้ร่วมกันสำหรับจุดสิ้นสุดการแมปอีเมล→คีย์ API ภายในของ Pearch API จำเป็นในโหมด oauth
PEARCH_MCP_OAUTH_STORE	disk	redis เก็บสถานะ OAuth (การลงทะเบียนไคลเอนต์, โทเค็น — เข้ารหัส) ใน Redis เพื่อให้คงอยู่หลังการรีสตาร์ทและรองรับมากกว่า 1 เรพลิกา
PEARCH_MCP_OAUTH_REDIS_HOST / REDIS_ENDPOINT, REDIS_PORT, PEARCH_MCP_OAUTH_REDIS_DB, REDIS_PASSWORD	—, 6379, 4, —	การเชื่อมต่อ Redis สำหรับที่เก็บ OAuth
PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS	รายการในตัว	รูปแบบ fnmatch คั่นด้วยเครื่องหมายจุลภาคสำหรับ URI เปลี่ยนเส้นทางของไคลเอนต์ MCP (* = ใดก็ได้)
PEARCH_MCP_TOKEN_CACHE_TTL_S	300	TTL แคชข้อมูลประจำตัวที่ยืนยันแล้ว; ยังเป็นความล่าช้าในการเพิกถอน
PEARCH_API_URL	https://api.pearch.ai	พื้นฐาน API Pearch (base_url ต่อการเรียกใช้แทนที่)
PEARCH_API_KEY	test_mcp_key	คีย์สำรองสำหรับการใช้งาน stdio/ในเครื่อง
MCP_DISABLE_AUTH	—	1 เทียบเท่ากับ PEARCH_MCP_AUTH=none (สำหรับการพัฒนาในเครื่องเท่านั้น)

ในโหมด oauth อินเกรส/พร็อกซีแบบย้อนกลับต้องกำหนดเส้นทางทั้งโฮสต์ไปยังเซิร์ฟเวอร์ ไม่ใช่แค่ /mcp: ขั้นตอนเพิ่ม /.well-known/oauth-*, /authorize, /token, /register, /revoke, /consent และ /auth/callback

การพัฒนา

export PEARCH_API_KEY='test_mcp_key'   # or your key for full results
fastmcp dev inspector pearch_mcp.py

นโยบายความเป็นส่วนตัว

นโยบายความเป็นส่วนตัวของ Pearch.AI: https://pearch.ai/privacy-policy — ครอบคลุมการเก็บรวบรวมข้อมูล, การใช้งาน, การจัดเก็บ, การแบ่งปันกับบุคคลที่สาม, การเก็บรักษา และข้อมูลติดต่อ การลบข้อมูล / การเลือกไม่เข้าร่วม: https://pearch.ai/opt-out. ข้อกำหนดการให้บริการ: https://pearch.ai/tos.

การสนับสนุน

• เปิด issue
• f@pearch.ai

สัญญาอนุญาต

MIT — ดู LICENSE