Mcp

net.barchinv1.0.0更新於 Oct 6, 2026

Web scraping and Iranian-web data tools for AI agents: JS rendering, proxies, Markdown output.

已驗證Streamable HTTP可網頁執行Web Search & ScrapingBrowser Automation

概覽

AI 產生的概覽

讓助理抓取即時網頁、擷取截圖或 PDF，並執行特定網站的抓取器，支援伊朗代理 IP 與 JavaScript 渲染。

功能
Barchin 提供一套遠端 MCP 工具，用來讀取即時網頁。scrape_url 抓取 URL，可選擇 JavaScript 渲染，可選用資料中心、住宅或解鎖代理，並輸出 Markdown、文字或 HTML；get_scrape 輪詢仍在處理中的結果。get_screenshot 將頁面擷取為 PNG 或 PDF。list_actors、run_actor 與 get_actor_run 涵蓋 82 個特定網站抓取器，並為精選子集提供直接的 actor_ 工具，get_balance 回傳剩餘額度。
適用情境
當助理需要從封鎖境外流量的網站（尤其是伊朗網站）取得頁面內容或截圖時適用，也適合目標網站已有專用抓取器的情況。它是託管服務，適合不希望在本機安裝的環境。
執行需求
遠端 Streamable HTTP 端點，無需安裝。工具呼叫需要 Authorization 標頭，攜帶從服務商主控台取得的 Bearer API 金鑰；tools/list 不需要金鑰。Claude Desktop 需要 mcp-remote 橋接。需要能連線該端點的網路。
安裝前請注意
工具呼叫會消耗付費額度：住宅代理、解鎖代理與 JavaScript 渲染比資料中心代理更貴，抓取器按個計價。Authorization Bearer 金鑰是可計費的機密，不應分享。抓取會把目標 URL 傳送給第三方服務，服務商條款與目標網站的規則仍然適用。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://barchin.net/mcp"
    }
  }
}

README

Barchin MCP — web access for AI agents on the Iranian web

Barchin gives AI agents a single MCP tool belt for reading the live web, built around an Iranian residential and datacenter proxy pool — IPs inside Iran that Iranian sites don't meet with the CAPTCHAs and blocks they throw at foreign ones — plus JavaScript rendering, anti-bot handling, and clean Markdown output, including Iranian sites that foreign scraping services cannot reach at all.

Why Barchin for Iranian sites

  • An Iranian IP pool. No foreign scraping API offers IPs inside Iran. Iranian sites are highly sensitive to foreign IPs — requests through non-Iranian proxies often trigger CAPTCHAs or get blocked outright, forcing retries that burn solver costs and credits. Iranian IPs mean fewer blocks, fewer retries, and a lower real cost per successful page.
  • Pay in Toman. No USD card, no currency-exchange intermediary and its fees, no sanctions friction.
  • Priced at or below foreign alternatives. Per-request pricing is equal to or lower than foreign scraping APIs — even before counting the extra fees Iranian users pay to make a dollar payment through an intermediary.

Endpoint

https://barchin.net/mcp

MCP Streamable HTTP transport. Remote only — nothing to install.

Try it — anonymous discovery works with no key:

bash
curl -s -X POST https://barchin.net/mcp \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Auth

  • tools/list needs no key — you can discover the tool belt anonymously.
  • Every tool call needs an Authorization: Bearer bk_live_... header.
  • Get a key at https://barchin.net/dashboard/api-keys.
  • Without a key, tool calls return an error — nothing runs, no credits are spent.

Tools

ToolDescription
scrape_url(url, render_js=true, proxy=auto|datacenter|residential|unblocker, country?, format=markdown|text|html, max_chars=40000, wait_for?)Fetches a URL and returns {request_id, status, final_url, http_status, content, format, truncated, credits_used, credits_remaining}. Waits up to 85 s, then returns status: "processing" if the page is still not ready.
get_scrape(request_id, format, max_chars)Polls/retrieves the result of a previously started scrape.
get_screenshot(url, full_page=false, format=png|pdf)Captures a screenshot or PDF of a page. Long renders return status: "processing" with a run_id instead.
list_actors()Lists all 82 active actors (site-specific scrapers) and each one's input schema.
run_actor(slug, input)Runs any active actor by slug — the generic way to call all 82 actors, not just the curated ones below.
get_actor_run(run_id)Polls/retrieves the result of a long actor run or screenshot that came back status: "processing" with a run_id.
actor_<slug>(...)Direct tools for a curated set of popular Iranian-web actors, e.g. actor_torob-product-sellers. Every other actor is reached via list_actors + run_actor.
get_balance()Returns remaining credits.

Connect

Claude Code

bash
claude mcp add --transport http barchin https://barchin.net/mcp --header "Authorization: Bearer bk_live_XXXX"

Cursor

.cursor/mcp.json:

json
{"mcpServers":{"barchin":{"url":"https://barchin.net/mcp","headers":{"Authorization":"Bearer bk_live_XXXX"}}}}

OpenAI Responses API (Python)

python
tools=[{"type":"mcp","server_label":"barchin","server_url":"https://barchin.net/mcp","headers":{"Authorization":"Bearer bk_live_XXXX"},"require_approval":"never"}]

Claude Desktop

Claude Desktop does not speak Streamable HTTP natively yet — bridge it with mcp-remote:

bash
npx mcp-remote https://barchin.net/mcp --header "Authorization: Bearer bk_live_XXXX"

Credits

Proxy typeCredits
Datacenter1
Residential15
Unblocker25
+ JS rendering+5
Actorspriced per actor

Markdown and text output are free (no extra cost over the proxy/rendering cost above). Failed requests are refunded.

Links

License

MIT

برچین برای ایجنت‌های هوش مصنوعی

برچین یک مجموعه ابزار MCP یکپارچه برای خواندن وب زنده در اختیار ایجنت‌های هوش مصنوعی قرار می‌دهد، بر پایه‌ی استخر پراکسی رزیدنشیال و دیتاسنتر ایرانی — IPهایی داخل ایران که سایت‌های ایرانی آن‌ها را با کپچا یا مسدودسازی مثل IPهای خارجی رد نمی‌کنند — به‌علاوه‌ی رندر جاوااسکریپت، مقابله با anti-bot و خروجی Markdown تمیز؛ حتی برای سایت‌های ایرانی که سرویس‌های اسکرپینگ خارجی اصلاً به آن‌ها دسترسی ندارند.

چرا برچین برای سایت‌های ایرانی

  • استخر IP ایرانی. هیچ API اسکرپینگ خارجی‌ای IP داخل ایران ندارد. سایت‌های ایرانی نسبت به IP خارجی بسیار حساس‌اند — درخواست از پروکسی غیرایرانی غالباً با کپچا یا مسدودسازی مواجه می‌شود، یعنی تلاش دوباره، هزینه‌ی حل کپچا و کردیت هدررفته. IP ایرانی یعنی مسدودسازی کمتر، تلاش دوباره کمتر و هزینه‌ی واقعی هر صفحه‌ی موفق پایین‌تر.
  • پرداخت به تومان. بدون کارت دلاری، بدون واسطه‌ی تبادل ارز و کارمزدش، بدون دردسر تحریم.
  • قیمتی برابر یا پایین‌تر از جایگزین‌های خارجی. هزینه‌ی هر درخواست با API‌های اسکرپینگ خارجی برابر یا کمتر است، آن هم پیش از کارمزدهایی که کاربر ایرانی برای پرداخت دلاری از طریق واسطه می‌پردازد.

آدرس سرویس (Endpoint)

https://barchin.net/mcp

ترنسپورت MCP Streamable HTTP. فقط به‌صورت ریموت — نیازی به نصب چیزی نیست.

امتحانش کنید — کشف ابزارها بدون کلید هم کار می‌کند: curl -s -X POST https://barchin.net/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

احراز هویت

  • فراخوانی tools/list نیاز به کلید ندارد — می‌توانید بدون احراز هویت لیست ابزارها را ببینید.
  • هر فراخوانی ابزار (tool call) نیاز به هدر Authorization: Bearer bk_live_... دارد.
  • کلید را از این آدرس بگیرید: https://barchin.net/dashboard/api-keys.
  • بدون کلید، فراخوانی ابزار خطا برمی‌گرداند — هیچ اجرایی انجام نمی‌شود و هیچ اعتباری مصرف نمی‌شود.

ابزارها

ابزارتوضیح
scrape_url(url, render_js=true, proxy=auto|datacenter|residential|unblocker, country?, format=markdown|text|html, max_chars=40000, wait_for?)یک URL را واکشی می‌کند و خروجی {request_id, status, final_url, http_status, content, format, truncated, credits_used, credits_remaining} برمی‌گرداند. حداکثر ۸۵ ثانیه منتظر می‌ماند و در صورت آماده نبودن صفحه، status: "processing" برمی‌گرداند.
get_scrape(request_id, format, max_chars)نتیجه یک درخواست اسکرپ قبلی را واکشی یا استعلام می‌کند.
get_screenshot(url, full_page=false, format=png|pdf)از صفحه، اسکرین‌شات یا PDF می‌گیرد. رندر طولانی به‌جای آن status: "processing" با یک run_id برمی‌گرداند.
list_actors()فهرست همه‌ی ۸۲ اکتور فعال (اسکرپرهای مخصوص سایت) و شِمای ورودی هرکدام را برمی‌گرداند.
run_actor(slug, input)هر اکتور فعال را با slug اجرا می‌کند؛ راه عمومی برای صدا کردن همه‌ی ۸۲ اکتور، نه‌فقط آن‌هایی که در جدول زیر ابزار مستقیم دارند.
get_actor_run(run_id)نتیجه‌ی یک اجرای طولانی اکتور یا اسکرین‌شات را که با status: "processing" و یک run_id برگشته بود، واکشی یا استعلام می‌کند.
actor_<slug>(...)ابزارهای مستقیم برای مجموعه‌ای منتخب از اکتورهای پرکاربرد وب ایران، مثلاً actor_torob-product-sellers. هر اکتور دیگری از طریق list_actors و run_actor در دسترس است.
get_balance()اعتبار باقی‌مانده را برمی‌گرداند.

اتصال

Claude Code

bash
claude mcp add --transport http barchin https://barchin.net/mcp --header "Authorization: Bearer bk_live_XXXX"

Cursor

فایل .cursor/mcp.json:

json
{"mcpServers":{"barchin":{"url":"https://barchin.net/mcp","headers":{"Authorization":"Bearer bk_live_XXXX"}}}}

OpenAI Responses API (پایتون)

python
tools=[{"type":"mcp","server_label":"barchin","server_url":"https://barchin.net/mcp","headers":{"Authorization":"Bearer bk_live_XXXX"},"require_approval":"never"}]

Claude Desktop

Claude Desktop هنوز به‌صورت مستقیم از Streamable HTTP پشتیبانی نمی‌کند — با mcp-remote آن را پل بزنید:

bash
npx mcp-remote https://barchin.net/mcp --header "Authorization: Bearer bk_live_XXXX"

اعتبارها (Credits)

نوع پراکسیاعتبار
دیتاسنتر۱
رزیدنشیال۱۵
آنبلاکر۲۵
+ رندر جاوااسکریپت+۵
اکتورهاقیمت‌گذاری به ازای هر اکتور

خروجی Markdown و متنی رایگان است (بدون هزینه اضافه نسبت به هزینه پراکسی/رندر بالا). درخواست‌های ناموفق اعتبار برگشتی دارند.

لینک‌ها

مجوز

MIT

來源：README.md，提交 5ed1cea

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v1.0.0最新Oct 6, 2026