Pearch

Pearch.ai MCP

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

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

उपकरण

उपकरण	विवरण
search_people	प्राकृतिक-भाषा लोगों की खोज (जैसे "कैलिफोर्निया में 5+ वर्ष Python अनुभव वाले सॉफ्टवेयर इंजीनियर")। फास्ट/प्रो/सुपरफास्ट खोज प्रकार, संपर्क प्रकटीकरण और संपर्क फ़िल्टर, रीयल-टाइम प्रोफ़ाइल रिफ़्रेश, अंतर्दृष्टि, और थ्रेड-आधारित पेजिनेशन/फॉलो-अप का समर्थन करता है।
search_company_leads	कंपनियों और उनके भीतर लीड्स/संपर्कों को खोजें (B2B)। उदाहरण: कंपनी "SF में AI स्टार्टअप, 50–200 कर्मचारी" + लीड्स "CTO और इंजीनियरिंग प्रबंधक", वैकल्पिक व्यक्तिगत आउटरीच संदेशों के साथ।
get_profile	LinkedIn स्लग या ईमेल द्वारा एक व्यक्ति को देखें और समृद्ध करें (संपर्क प्रकटीकरण, रीयल-टाइम रिफ़्रेश, 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 कुंजी

वही 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 वेब एप्लिकेशन क्लाइंट (<base_url>/auth/callback को रीडायरेक्ट URI के रूप में पंजीकृत करें)। oauth मोड में आवश्यक।
PEARCH_MCP_INTERNAL_TOKEN	—	Pearch API के आंतरिक ईमेल→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, —	OAuth स्टोर के लिए Redis कनेक्शन।
PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS	अंतर्निहित सूची	MCP क्लाइंट रीडायरेक्ट URIs के लिए अल्पविराम-पृथक 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 के बराबर है (केवल स्थानीय विकास)।

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 देखें।