TinyFish

परिचय

TinyFish, TinyFish वेब एजेंट के लिए एक MCP एकीकरण है। इसका होस्टेड एंडपॉइंट MCP-संगत सहायकों को वेब ऑटोमेशन, खोज, सामग्री निष्कर्षण, रन प्रबंधन और रिमोट ब्राउज़र-सत्र क्षमताओं तक पहुंच प्रदान करता है। TinyFish, MIT-लाइसेंस प्राप्त एक TypeScript पैकेज, @tiny-fish/mcp भी प्रकाशित करता है, जो अपने स्वयं के उपकरणों या स्कीमा को परिभाषित करने के बजाय होस्टेड MCP सेवा के लिए एक स्थानीय रिवर्स प्रॉक्सी के रूप में कार्य करता है।

मुख्य विशेषताएं

• run_web_automation और run_web_automation_async के माध्यम से लक्ष्य-आधारित ब्राउज़र ऑटोमेशन, जिसमें get_run, list_runs और cancel_run के माध्यम से रन निरीक्षण और रद्दीकरण की सुविधा है।
• search के माध्यम से वेब खोज, साथ ही get_search_usage के माध्यम से खोज-उपयोग निरीक्षण।
• fetch_content के माध्यम से ब्राउज़र-रेंडर्ड सामग्री निष्कर्षण, जिसमें list_fetch_usage के माध्यम से उपयोग मेटाडेटा उपलब्ध है।
• Playwright, Puppeteer या Selenium के साथ प्रत्यक्ष नियंत्रण के लिए create_browser_session, list_browser_sessions और close_browser_session के माध्यम से रिमोट Chrome सत्र।
• कई ऑटोमेशन रन के लिए बैच स्थिति और रद्दीकरण उपकरण।
• प्रोफ़ाइल-जागरूक ऑटोमेशन, सहेजे गए ब्राउज़र संदर्भ का पुन: उपयोग कर सकता है और बार-बार होने वाले प्रमाणित वर्कफ़्लो के लिए वैकल्पिक रूप से TinyFish Vault क्रेडेंशियल का उपयोग कर सकता है।

उपयोग के मामले

TinyFish उन एजेंटों के लिए उपयुक्त है जिन्हें प्राकृतिक-भाषा लक्ष्यों से वेबसाइटों पर नेविगेट करने, लाइव वेब सामग्री निकालने, वर्तमान जानकारी खोजने, फॉर्म और प्रमाणित अनुप्रयोगों के साथ बातचीत करने, या किसी ऑटोमेशन फ्रेमवर्क को रिमोट ब्राउज़र सत्र सौंपने की आवश्यकता होती है। एसिंक रन और रन-प्रबंधन उपकरण लंबे वर्कफ़्लो के लिए उपयोगी होते हैं जहाँ कॉल करने वाले एजेंट को काम शुरू करना चाहिए और बाद में पूर्णता के लिए पोल करना चाहिए।

संगतता

प्राथमिक सेवा Streamable HTTP का उपयोग करने वाला एक होस्टेड MCP एंडपॉइंट है। वर्तमान TinyFish दस्तावेज़ Codex, Grok, Claude Code, OpenCode, Claude Desktop, ChatGPT, Cursor और Windsurf के लिए क्लाइंट-विशिष्ट सेटअप प्रदान करता है, और सेवा को अन्य MCP-संगत सहायकों से उपयोग करने योग्य बताता है। वैकल्पिक स्थानीय प्रॉक्सी एक लूपबैक HTTP MCP एंडपॉइंट को उजागर करता है और रिपॉजिटरी Claude Code, Claude Desktop, Cursor, VS Code और सामान्य URL-आधारित MCP क्लाइंट के लिए कॉन्फ़िगरेशन का दस्तावेज़ीकरण करता है।

सीमाएं

• होस्टेड MCP प्रवाह के लिए TinyFish खाता और OAuth 2.1 प्राधिकरण आवश्यक है; TinyFish दस्तावेज़ कहता है कि खाते में एक सक्रिय सदस्यता या क्रेडिट होना चाहिए।
• वर्तमान मूल्य निर्धारण मॉडल में खोज और सामग्री-फ़ेच उपकरण मुफ्त हैं, जबकि एजेंट ऑटोमेशन और रिमोट ब्राउज़र सत्र TinyFish क्रेडिट का उपभोग करते हैं।
• स्थानीय @tiny-fish/mcp पैकेज केवल होस्टेड सेवा के लिए एक प्रॉक्सी है, इसलिए यह TinyFish उपकरणों का एक स्वतंत्र ऑफ़लाइन कार्यान्वयन प्रदान नहीं करता है।
• स्थानीय प्रॉक्सी के लिए Node.js 22 या नया और TINYFISH_API_KEY आवश्यक है। यह केवल लूपबैक से बंधता है, लेकिन कोई भी विश्वसनीय स्थानीय प्रक्रिया जो इसके सुनने वाले पोर्ट तक पहुँच सकती है, सर्वर-धारित कुंजी का उपयोग करके ऑटोमेशन को लागू कर सकती है।
• स्थानीय प्रॉक्सी दस्तावेज़ के अनुसार, होस्टेड सेवा द्वारा JSON-RPC बैच सरणियाँ समर्थित नहीं हैं।

स्रोत

• आधिकारिक MCP दस्तावेज़ीकरण: https://docs.tinyfish.ai/mcp-integration
• प्रमाणीकरण: https://docs.tinyfish.ai/authentication
• मूल्य निर्धारण: https://www.tinyfish.ai/pricing
• GitHub: https://github.com/tinyfish-io/tinyfish-mcp-server
• npm: https://www.npmjs.com/package/@tiny-fish/mcp

MCP सेटअप

पूर्वापेक्षाएँ

• होस्टेड MCP सेवा के लिए सक्रिय सब्सक्रिप्शन या क्रेडिट वाला TinyFish खाता
• अनुशंसित होस्टेड सेटअप के लिए रिमोट HTTP MCP सर्वर से कनेक्ट हो सकने वाला MCP क्लाइंट
• केवल वैकल्पिक @tiny-fish/mcp लोकल प्रॉक्सी का उपयोग करते समय Node.js >= 22
• केवल वैकल्पिक @tiny-fish/mcp लोकल प्रॉक्सी का उपयोग करते समय TinyFish API कुंजी

पहुँच आवश्यकताएँ

• होस्टेड MCP प्रमाणीकरण ब्राउज़र में OAuth 2.1 का उपयोग करता है
• वैकल्पिक लोकल प्रॉक्सी को स्टार्टअप पर TINYFISH_API_KEY की आवश्यकता होती है और इसे X-API-Key के रूप में अपस्ट्रीम भेजता है
• वर्तमान TinyFish मूल्य निर्धारण मॉडल में खोज और फ़ेच मुफ्त हैं; एजेंट ऑटोमेशन और ब्राउज़र सत्र क्रेडिट का उपभोग करते हैं

सहायक ऐप या प्लगइन

नाम: @tiny-fish/mcp लोकल प्रॉक्सी इंस्टॉल URL: https://www.npmjs.com/package/@tiny-fish/mcp

• ग्लोबली इंस्टॉल करें: npm install -g @tiny-fish/mcp
• वैकल्पिक रूप से बिना इंस्टॉल किए चलाएँ: npx @tiny-fish/mcp
• पर्यावरण में TINYFISH_API_KEY सेट करें।
• tinyfish-mcp शुरू करें और MCP क्लाइंट को http://127.0.0.1:3711/mcp पर पॉइंट करें।

वैकल्पिक। रिपॉजिटरी सीधे होस्टेड एंडपॉइंट की सिफारिश करता है जब क्लाइंट रिमोट स्ट्रीमेबल HTTP को सपोर्ट करता हो। केवल-लोकल क्लाइंट या CI, हेडलेस मशीनों और स्क्रिप्ट्स में API-कुंजी प्रमाणीकरण के लिए लोकल प्रॉक्सी का उपयोग करें।

क्लाइंट सेटअप

Claude Code

ट्रांसपोर्ट: http

claude mcp add --transport http tinyfish https://agent.tinyfish.ai/mcp

• होस्टेड TinyFish MCP सर्वर जोड़ने के लिए दस्तावेज़ित Claude Code कमांड चलाएँ।

प्रमाणीकरण:

• पहले उपयोग पर, ब्राउज़र में TinyFish OAuth 2.1 प्रवाह पूरा करें।

होस्टेड एंडपॉइंट; किसी स्थानीय TinyFish प्रक्रिया की आवश्यकता नहीं है।

Claude Desktop

ट्रांसपोर्ट: http

{
  "mcpServers": {
    "tinyfish": {
      "url": "https://agent.tinyfish.ai/mcp"
    }
  }
}

• https://agent.tinyfish.ai/mcp का उपयोग करके TinyFish को कस्टम कनेक्टर के रूप में जोड़ें, या दस्तावेज़ित URL-आधारित सर्वर कॉन्फ़िगरेशन का उपयोग करें।
• कॉन्फ़िगरेशन संपादित करने के बाद Claude Desktop को पुनरारंभ करें।

प्रमाणीकरण:

• जब Claude Desktop प्रमाणीकरण का अनुरोध करे तो ब्राउज़र OAuth प्रवाह पूरा करें।

TinyFish सीधे होस्टेड URL की सिफारिश करता है।

Cursor

ट्रांसपोर्ट: http

{
  "mcpServers": {
    "tinyfish": {
      "url": "https://agent.tinyfish.ai/mcp"
    }
  }
}

• Cursor MCP सेटिंग्स में दस्तावेज़ित TinyFish एंट्री जोड़ें।

प्रमाणीकरण:

• संकेत मिलने पर ब्राउज़र में TinyFish OAuth 2.1 पूरा करें।

होस्टेड एंडपॉइंट।

Codex

ट्रांसपोर्ट: http

codex mcp add tinyfish --url https://agent.tinyfish.ai/mcp

• TinyFish जोड़ने के लिए दस्तावेज़ित Codex कमांड चलाएँ।

प्रमाणीकरण:

• जब क्लाइंट प्राधिकरण का अनुरोध करे तो TinyFish OAuth 2.1 पूरा करें।

होस्टेड एंडपॉइंट।

Windsurf

परिवहन: http

{
  "mcpServers": {
    "tinyfish": {
      "serverUrl": "https://agent.tinyfish.ai/mcp"
    }
  }
}

• Windsurf MCP कॉन्फ़िगरेशन में प्रलेखित TinyFish सर्वर प्रविष्टि जोड़ें।

प्रमाणीकरण:

• संकेत मिलने पर ब्राउज़र में TinyFish OAuth 2.1 पूरा करें।

होस्टेड एंडपॉइंट।

VS Code

परिवहन: http

{
  "servers": {
    "tinyfish": {
      "type": "http",
      "url": "http://127.0.0.1:3711/mcp"
    }
  }
}

• वैकल्पिक @tiny-fish/mcp लोकल प्रॉक्सी प्रारंभ करें।
• रिपॉजिटरी में प्रलेखित .vscode/mcp.json कॉन्फ़िगरेशन का उपयोग करें जो http://127.0.0.1:3711/mcp की ओर इंगित करता है।

रिपॉजिटरी VS Code के लिए इस लोकल-प्रॉक्सी सेटअप का दस्तावेजीकरण करती है। TinyFish MCP एकीकरण पृष्ठ पर वर्तमान VS Code-विशिष्ट होस्टेड कॉन्फ़िगरेशन का दस्तावेजीकरण नहीं किया गया है।

Lovable

Lovable के लिए सटीक सार्वजनिक TinyFish MCP सेटअप का दस्तावेजीकरण नहीं किया गया है।

अन्य

परिवहन: http

• क्लाइंट की रिमोट स्ट्रीमेबल HTTP सर्वर सेटिंग्स का उपयोग करके होस्टेड MCP एंडपॉइंट https://agent.tinyfish.ai/mcp कॉन्फ़िगर करें।

प्रमाणीकरण:

• यदि क्लाइंट होस्टेड प्राधिकरण प्रवाह का समर्थन करता है तो TinyFish OAuth 2.1 पूरा करें।

TinyFish दस्तावेज़ एंडपॉइंट को MCP-संगत सहायकों से उपयोग करने योग्य बताता है और अलग से Grok, OpenCode, और ChatGPT का दस्तावेजीकरण करता है। सटीक कॉन्फ़िगरेशन सिंटैक्स क्लाइंट के अनुसार भिन्न होता है।

प्राधिकरण प्रवाह

• https://agent.tinyfish.ai/mcp को किसी समर्थित MCP क्लाइंट में जोड़ें।
• पहली बार उपयोग करने पर, क्लाइंट OAuth 2.1 प्राधिकरण के लिए एक ब्राउज़र खोलता है।
• TinyFish खाते से साइन इन करें और कनेक्शन को अधिकृत करें।
• प्राधिकरण बाद के सत्रों के लिए कैश्ड रहता है।

पर्यावरण चर

• TINYFISH_API_KEY — वैकल्पिक लोकल प्रॉक्सी के लिए आवश्यक
• PORT — वैकल्पिक लोकल प्रॉक्सी सुनने का पोर्ट; डिफ़ॉल्ट 3711
• TINYFISH_UPSTREAM_URL — वैकल्पिक लोकल प्रॉक्सी अपस्ट्रीम ओवरराइड; डिफ़ॉल्ट https://agent.tinyfish.ai/mcp

सेटअप दस्तावेज़: https://docs.tinyfish.ai/mcp-integration