Pearch

Pearch.ai MCP

Pearch.AI के लिए MCP सर्वर: लोगों और कंपनियों/लीड्स (B2B) पर प्राकृतिक-भाषा खोज। इसे Claude, Cursor, VS Code, या किसी भी MCP-संगत क्लाइंट से उपयोग करें।

मानवीय प्राथमिकता द्वारा AI भर्ती सोर्सिंग टूल्स का मूल्यांकन

टूल्स

टूल	विवरण
search_people	प्राकृतिक-भाषा query या संरचित search_requirements के साथ लोगों की खोज। fast/pro/superfast खोज प्रकार, संपर्क प्रकटीकरण और संपर्क फ़िल्टर, रीयल-टाइम प्रोफ़ाइल रीफ़्रेश, इनसाइट्स, और थ्रेड-आधारित पेजिनेशन/फ़ॉलो-अप का समर्थन करता है।
search_company_leads	कंपनियाँ और उनके भीतर लीड्स/संपर्क खोजें (B2B)। उदाहरण: कंपनी "SF में AI स्टार्टअप्स, 50–200 कर्मचारी" + लीड्स "CTO और इंजीनियरिंग मैनेजर", वैकल्पिक व्यक्तिगत आउटरीच संदेशों के साथ।
get_profile	LinkedIn स्लग या ईमेल द्वारा किसी एक व्यक्ति को खोजें और समृद्ध करें (संपर्क प्रकटीकरण, रीयल-टाइम रीफ़्रेश, GitHub संवर्धन)।
get_user_info	प्रमाणित उपयोगकर्ता जानकारी: ईमेल, शेष क्रेडिट, मूल्य निर्धारण योजना। निःशुल्क।

संरचित लोगों की खोज

जब आपके पास पहले से मानदंडों की सूची हो तो search_people को search_requirements पास करें:

{
  "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 (डिफ़ॉल्ट)।

सूची में कम से कम एक आवश्यकता होनी चाहिए। search_requirements का उपयोग करते समय query वैकल्पिक है; यदि दोनों प्रदान किए जाएँ, तो API search_requirements को प्राथमिकता देता है। Pearch खोज 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 कुंजी नहीं है, तो पहले Pearch.ai डैशबोर्ड में एक बनाएँ।

API कुंजी

वही Pearch API कुंजी 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 मेटाडेटा, टोकन ऑडियंस, और /auth/callback रीडायरेक्ट URI सभी इससे प्राप्त होते हैं।
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET	—	Google OAuth 2.0 Web एप्लिकेशन क्लाइंट (<base_url>/auth/callback को रीडायरेक्ट URI के रूप में पंजीकृत करें)। oauth मोड में आवश्यक।
PEARCH_MCP_INTERNAL_TOKEN	—	आंतरिक ईमेल→API-कुंजी मैपिंग और अनुरोध-स्रोत हस्ताक्षर के लिए साझा रहस्य। oauth मोड में और API कुंजियों के साथ सत्यापित MCP एट्रिब्यूशन के लिए आवश्यक। बैकएंड के 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, —	OAuth स्टोर के लिए Redis कनेक्शन।
PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS	अंतर्निहित सूची	MCP क्लाइंट रीडायरेक्ट URI के लिए अल्पविराम-पृथक fnmatch पैटर्न (* = कोई भी)।
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 को टूल अनुरोध POST और GET दोनों कॉल पर X-Pearch-Source: mcp शामिल करते हैं, जिसमें लोगों की खोज, कंपनी-लीड्स खोज, पेजिनेशन, और प्रोफ़ाइल संवर्धन शामिल हैं। होस्टेड सर्वर X-Pearch-Source-Signature भी भेजता है जब आंतरिक रहस्य कॉन्फ़िगर होता है और गंतव्य ओरिजिन PEARCH_API_URL से मेल खाता है। HMAC बियरर क्रेडेंशियल, विधि, डिकोडेड पथ और कच्ची क्वेरी, बॉडी, और टाइमस्टैम्प को बांधता है। बैकएंड 300 सेकंड के भीतर हस्ताक्षर स्वीकार करता है, इसलिए सर्वर घड़ियाँ सिंक्रनाइज़ होनी चाहिए। अन्य ओरिजिन पर कॉलर-प्रदत्त base_url मानों को कोई हस्ताक्षर नहीं मिलता।

बैकएंड सत्यापित MCP ट्रैफ़िक को एनालिटिक्स और DevAdmin इतिहास के लिए api_calls.request_source के रूप में रिकॉर्ड करता है। केवल एक स्रोत हेडर पर्याप्त नहीं है। API कुंजियों का उपयोग करने वाला अहस्ताक्षरित स्व-होस्टेड MCP ट्रैफ़िक 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.

सहायता

• एक इश्यू खोलें
• f@pearch.ai

लाइसेंस

MIT — LICENSE देखें।