How do I install Barchin?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Barchin need an API key?

No required environment variable is listed on this record.

When was Barchin last checked?

Last checked 2026-11-10. Web scraping and Iranian-web data tools for AI agents: JS rendering, proxies, Markdown output.

Barchin MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://barchin.net/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http net.barchin-mcp https://barchin.net/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "net.barchin-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://barchin.net/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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:

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

Tool	Description
`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

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

Cursor

.cursor/mcp.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 does not speak Streamable HTTP natively yet — bridge it with mcp-remote:

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

Credits

Proxy type	Credits
Datacenter	1
Residential	15
Unblocker	25
+ JS rendering	+5
Actors	priced per actor

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

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

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

Cursor

فایل .cursor/mcp.json:

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

OpenAI Responses API (پایتون)

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 آن را پل بزنید:

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

اعتبارها (Credits)

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

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

لینک‌ها

مجوز

MIT

Barchin

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Barchin?

Does Barchin need an API key?

What transport does Barchin use?

When was Barchin last checked?

Documentation

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

Why Barchin for Iranian sites

Endpoint

Auth

Tools

Connect

Claude Code

Cursor

OpenAI Responses API (Python)

Claude Desktop

Credits

Links

License

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

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

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

احراز هویت

ابزارها

اتصال

Claude Code

Cursor

OpenAI Responses API (پایتون)

Claude Desktop

اعتبارها (Credits)

لینک‌ها

مجوز