barchin

Name: barchin
Author: barchin.net

远程服务

github.com/barchin-net浏览器自动化03 周前更新

代码仓库

关于 barchin

barchin 是面向需要获取实时网页内容的 Agent 的远程 MCP 服务，尤其适用于伊朗网站。它结合伊朗代理、JavaScript 渲染、反机器人处理、页面截图和站点专用 actor。

主要功能

01使用可选代理模式抓取网页
02渲染 JavaScript 并返回 Markdown
03截取页面或生成 PDF
04运行站点专用 actor
05获取长时间任务的结果
06查询剩余额度

适用场景

01获取伊朗网站的内容
02使用站点专用 actor 收集结构化数据
03将网页保存为图像或 PDF
04轮询仍在处理中的抓取或 actor 任务

MCP 相关

它通过 https://barchin.net/mcp 提供远程 Streamable HTTP 接入，开放抓取、截图、actor、结果查询和额度工具。工具发现无需认证；调用工具需要 bearer API 密钥。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://barchin.net/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http net-barchin https://barchin.net/mcp

Cursor.cursor/mcp.json{"mcpServers":{"net-barchin":{"type":"http","url":"https://barchin.net/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"net-barchin":{"type":"http","url":"https://barchin.net/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"net-barchin":{"type":"http","url":"https://barchin.net/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"net-barchin":{"serverUrl":"https://barchin.net/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址

Streamable HTTPhttps://barchin.net/mcp需要授权

工具

参数	类型	必填	说明
url	string	是	要获取的绝对 http(s) URL。
proxy	enum	否	代理池。auto（默认）仅在需要时才从最便宜的代理池逐级升级，并且只按成功的级别收费。datacenter=1 个额度，residential=15，unblocker=25（启用 render_js 时各额外加 5）。auto \| datacenter \| residential \| unblocker
format	enum	否	输出格式。markdown/text 会在读取时根据获取的 HTML 生成，不会产生额外费用。markdown \| text \| html
country	string	否	出口 IP 的两字母 ISO 国家/地区代码，例如 'ir'。省略则表示全球范围。
wait_for	string	否	页面加载后、读取内容前要等待的 CSS 选择器。仅在 render_js=true 时有效。
max_chars	integer	否	将 Markdown/文本输出截断到此字符数。
render_js	boolean	否	在真实浏览器中渲染页面（JavaScript/SPA 内容）。额外消耗 5 个额度；对于纯 HTML 页面请关闭以节省额度。

详细介绍

Barchin MCP — 为 AI Agent 提供伊朗网络访问能力

Barchin 为 AI Agent 提供一套统一的 MCP 工具集，用于读取实时网络内容。它基于伊朗住宅和数据中心代理 IP 池构建——这些位于伊朗境内的 IP，不会像外国 IP 那样遭遇伊朗网站设置的 CAPTCHA 和拦截；此外还支持 JavaScript 渲染、反机器人处理和整洁的 Markdown 输出，也能访问外国抓取服务完全无法触及的伊朗网站。

为什么选择 Barchin 访问伊朗网站

伊朗 IP 池。 没有外国抓取 API 能提供位于伊朗境内的 IP。伊朗网站对外国 IP 高度敏感——通过非伊朗代理发送的请求往往会触发 CAPTCHA 或直接被拦截，迫使用户重试，消耗 CAPTCHA 求解费用和额度。使用伊朗 IP 意味着更少的拦截、更少的重试，以及更低的每个成功页面的实际成本。
使用托曼付款。 无需美元银行卡，无需货币兑换中间商及其手续费，也没有制裁带来的阻碍。
价格不高于外国替代服务。 单次请求的价格与外国抓取 API 相同或更低——而且这还没有算上伊朗用户通过中间商进行美元付款时需要额外支付的费用。

端点

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 无需密钥——你可以匿名发现工具集。
每次工具调用都需要 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}`。最多等待 85 秒；如果页面仍未准备就绪，则返回 `status: "processing"`。
`get_scrape(request_id, format, max_chars)`	轮询或获取先前启动的抓取任务结果。
`get_screenshot(url, full_page=false, format=png\|pdf)`	截取页面截图或生成 PDF。耗时较长的渲染会返回带有 `run_id` 的 `status: "processing"`。
`list_actors()`	列出所有 82 个启用的 Actor（特定网站的抓取器）及其各自的输入架构。
`run_actor(slug, input)`	根据 slug 运行任意启用的 Actor——这是调用全部 82 个 Actor 的通用方式，而不仅限于下方精选的 Actor。
`get_actor_run(run_id)`	轮询或获取耗时较长的 Actor 运行任务或截图结果；这类任务会以带有 `run_id` 的 `status: "processing"` 返回。
`actor_<slug>(...)`	为一组精选的热门伊朗网络 Actor 提供直接工具，例如 `actor_torob-product-sellers`。其他所有 Actor 均通过 `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（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 桥接：

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

额度

代理类型	额度
数据中心	1
住宅	15
解封代理	25
+ JS 渲染	+5
Actor	按 Actor 定价

Markdown 和文本输出免费（不在上述代理／渲染费用之外额外收费）。失败的请求会退还额度。

链接

许可证

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

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

barchin

关于 barchin

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Barchin MCP — 为 AI Agent 提供伊朗网络访问能力

为什么选择 Barchin 访问伊朗网站

端点

身份验证

工具

连接

Claude Code

Cursor

OpenAI Responses API（Python）

Claude Desktop

额度

链接

许可证

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

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

احراز هویت

ابزارها

اتصال

Claude Code

Cursor

OpenAI Responses API (پایتون)

Claude Desktop

اعتبارها (Credits)

لینک‌ها

مجوز

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？