Pearch

Pearch.ai MCP

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

Evaluating AI Recruitment Sourcing Tools by Human Preference

เครื่องมือ

เครื่องมือ	คำอธิบาย
search_people	ค้นหาบุคคลด้วย query แบบภาษาธรรมชาติ หรือ search_requirements แบบมีโครงสร้าง รองรับประเภทการค้นหา fast/pro/superfast, การเปิดเผยข้อมูลติดต่อและตัวกรองข้อมูลติดต่อ, การรีเฟรชโปรไฟล์แบบเรียลไทม์, ข้อมูลเชิงลึก และการแบ่งหน้า/การติดตามผลแบบเธรด
search_company_leads	ค้นหาบริษัทและลีด/ผู้ติดต่อภายในบริษัทเหล่านั้น (B2B) ตัวอย่าง: บริษัท "AI startups in SF, 50–200 employees" + ลีด "CTOs and engineering managers" พร้อมข้อความติดต่อแบบเฉพาะบุคคลได้ตามต้องการ
get_profile	ค้นหาและเสริมข้อมูลบุคคลรายเดียวด้วย LinkedIn slug หรืออีเมล (การเปิดเผยข้อมูลติดต่อ, การรีเฟรชแบบเรียลไทม์, การเสริมข้อมูลจาก GitHub)
get_user_info	ข้อมูลผู้ใช้ที่ผ่านการยืนยันตัวตน: อีเมล, เครดิตคงเหลือ, แผนราคา ฟรี

การค้นหาบุคคลแบบมีโครงสร้าง

ส่ง search_requirements ไปยัง search_people เมื่อคุณมีรายการเกณฑ์อยู่แล้ว:

{
  "search_requirements": [
    {
      "search_requirement": "Software engineer with 5+ years of Python experience",
      "must_have": true
    },
    {
      "search_requirement": "Experience at a fintech company",
      "must_have": false
    }
  ],
  "search_type": "fast",
  "limit": 10,
  "insights": true,
  "reveal_emails": true
}

• search_requirement: จำเป็น ต้องเป็นข้อความที่ไม่ว่างเปล่า เก็บแต่ละเกณฑ์ให้สั้นและสมบูรณ์ในตัวเอง
• must_have: true สำหรับเกณฑ์บังคับ, false สำหรับความต้องการเสริม (ค่าเริ่มต้น)

รายการต้องมีอย่างน้อยหนึ่งข้อกำหนด query เป็นทางเลือกเมื่อใช้ search_requirements; หากระบุทั้งสองอย่าง API จะให้ search_requirements มีความสำคัญกว่า ดู สัญญา Pearch search API

อินพุตทั้งสองรองรับตัวเลือกการค้นหาเดียวกัน: ประเภทการค้นหา, ข้อมูลเชิงลึกและการให้คะแนน, การรีเฟรชโปรไฟล์, การเปิดเผยข้อมูลติดต่อและตัวกรอง, การกรองแบบเข้มงวด, ผลลัพธ์ที่มีความมั่นใจต่ำ, งบเวลาการค้นหา, การแบ่งหน้า, ฟิลด์การตอบกลับ, การยกเว้นโปรไฟล์ และผลลัพธ์แบบปิดบังฟรี ข้อจำกัดของประเภทการค้นหาเหมือนกันสำหรับอินพุตทั้งสอง ตัวอย่างเช่น superfast ไม่รองรับข้อมูลเชิงลึก, การให้คะแนนโปรไฟล์ หรือความสดใหม่สูง

สำหรับการแบ่งหน้า ให้ส่ง thread_id ที่ได้คืนมาพร้อมกับ limit และอาจระบุ offset ด้วย โดยไม่ต้องระบุ query และ search_requirements หากต้องการเปลี่ยนเกณฑ์ ให้เริ่มการค้นหาใหม่ โดยไม่ต้องระบุ thread_id การเรียก query ที่มีอยู่และการติดตามผลแบบเธรดยังคงถูกส่งต่อ เหมือนเดิม; API เป็นผู้ตัดสินใจว่าจะยอมรับพารามิเตอร์การติดตามผลใด

custom_filters ไม่ได้เปิดเผยโดยเซิร์ฟเวอร์ MCP นี้ ให้แสดงเกณฑ์ใน query หรือ 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 key ให้สร้างก่อนใน Pearch.ai Dashboard

API key

ส่ง Pearch API key เดียวกันเป็น 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 ยังคงยอมรับ bearer แบบ API-key ดิบ (การยืนยันตัวตนแบบคู่)
PEARCH_MCP_BASE_URL	http://localhost:8000	URL สาธารณะของเซิร์ฟเวอร์นี้ เมทาดาทา OAuth, audience ของโทเค็น และ redirect URI ของ /auth/callback ล้วนได้มาจากค่านี้
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET	—	ไคลเอนต์ Google OAuth 2.0 Web application (ลงทะเบียน <base_url>/auth/callback เป็น redirect URI) จำเป็นในโหมด oauth
PEARCH_MCP_INTERNAL_TOKEN	—	ซีเคร็ตที่ใช้ร่วมกันสำหรับการแมปอีเมล→API-key ภายในและการลงนามแหล่งที่มาของคำขอ จำเป็นในโหมด oauth และสำหรับการระบุแหล่งที่มา MCP ที่ผ่านการยืนยันด้วย API key ต้องตรงกับ MCP_INTERNAL_TOKEN ของแบ็กเอนด์; ห้ามแจกจ่ายให้ผู้ใช้ปลายทาง
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 คั่นด้วยจุลภาคสำหรับ redirect URI ของไคลเอนต์ MCP (* = ใดก็ได้)
PEARCH_MCP_TOKEN_CACHE_TTL_S	300	TTL ของแคชตัวตนที่ยืนยันแล้ว; รวมถึงระยะหน่วงของการเพิกถอนด้วย
PEARCH_API_URL	https://api.pearch.ai	ฐานของ Pearch API (base_url ต่อการเรียกจะเขียนทับ)
PEARCH_API_KEY	test_mcp_key	คีย์สำรองสำหรับการใช้งาน stdio/โลคอล
MCP_DISABLE_AUTH	—	1 เทียบเท่ากับ PEARCH_MCP_AUTH=none (สำหรับการพัฒนาโลคอลเท่านั้น)

คำขอเครื่องมือไปยัง Pearch API จะมี X-Pearch-Source: mcp ทั้งในการเรียก POST และ GET รวมถึงการค้นหาบุคคล, การค้นหาลีดบริษัท, การแบ่งหน้า และการเสริมข้อมูลโปรไฟล์ เซิร์ฟเวอร์ที่โฮสต์ยังส่ง X-Pearch-Source-Signature เมื่อมีการกำหนดค่าซีเคร็ตภายใน และต้นทางปลายทางตรงกับ PEARCH_API_URL HMAC ผูกกับข้อมูลรับรอง bearer, เมธอด, พาธที่ถอดรหัสแล้วพร้อม query ดิบ, บอดี้ และเวลาประทับ แบ็กเอนด์ยอมรับลายเซ็น ภายใน 300 วินาที ดังนั้นนาฬิกาของเซิร์ฟเวอร์ต้องซิงโครไนซ์กัน ค่า base_url ที่ผู้เรียกส่งมา บนต้นทางอื่นจะไม่ได้รับลายเซ็น

แบ็กเอนด์บันทึกทราฟฟิก MCP ที่ผ่านการยืนยันเป็น api_calls.request_source สำหรับการวิเคราะห์และ ประวัติ DevAdmin เฮดเดอร์แหล่งที่มาแบบเปล่า ๆ ไม่เพียงพอ ทราฟฟิก MCP แบบโฮสต์เองที่ไม่ได้ลงนาม ซึ่งใช้ API key ยังคงเป็น api; ไคลเอนต์ OAuth ที่อยู่ในรายการอนุญาตและผ่านการยืนยันตัวตนจะถูกจดจำได้โดยไม่ต้องมี เฮดเดอร์ ให้ติดตั้งการลงนามก่อนเปิดใช้การบันทึกแหล่งที่มาของแบ็กเอนด์ หลังจากใช้การย้ายฐานข้อมูล ของมันแล้ว แบ็กเอนด์รุ่นเก่าจะเพิกเฉยต่อเฮดเดอร์เหล่านี้ การยืนยันตัวตน, การระบุบัญชี และ การเรียกเก็บเงินไม่เปลี่ยนแปลง

ในโหมด 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