barchin について
barchinは、ライブウェブコンテンツ、特にイランのサイトからの取得を必要とするエージェント向けのリモートMCPサーバーです。イランのプロキシ、JavaScriptレンダリング、ボット対策、スクリーンショット、サイト別actorを組み合わせています。
主な機能
- 01プロキシ方式を選んでページをスクレイピング
- 02JavaScriptをレンダリングして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/mcpclaude mcp add --transport http net-barchin https://barchin.net/mcp{"mcpServers":{"net-barchin":{"type":"http","url":"https://barchin.net/mcp"}}}Cursor で開く{"servers":{"net-barchin":{"type":"http","url":"https://barchin.net/mcp"}}}VS Code で開く{"mcpServers":{"net-barchin":{"type":"http","url":"https://barchin.net/mcp"}}}{"mcpServers":{"net-barchin":{"serverUrl":"https://barchin.net/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
https://barchin.net/mcp認証が必要ツール
17| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| 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 の 2 文字の ISO 国コード(例:'ir')。全世界を対象にする場合は省略します。 |
| wait_for | string | いいえ | ページの読み込み後、内容を読み取る前に待機する CSS セレクター。render_js=true の場合のみ有効です。 |
| max_chars | integer | いいえ | Markdown/テキスト出力をこの文字数で切り詰めます。 |
| render_js | boolean | いいえ | 実際のブラウザーでページをレンダリングします(JavaScript/SPA コンテンツ)。追加で 5 クレジットかかります。クレジットを節約するには、通常の HTML ページではオフにしてください。 |
詳細
Barchin MCP — イランのウェブにおける AI エージェント向けウェブアクセス
Barchin は、イランの住宅用およびデータセンター用プロキシプールを基盤に、ライブウェブを読み取るための単一の MCP ツールセットを AI エージェントに提供します。イラン国内の IP を使用するため、イランのサイトで外国の IP に対して表示される CAPTCHA やブロックを回避できます。さらに、JavaScript のレンダリング、ボット対策への対応、整形された Markdown 出力にも対応し、海外のスクレイピングサービスではまったくアクセスできないイランのサイトも取得できます。
イランのサイトに Barchin を使う理由
- イランの IP プール。 イラン国内の IP を提供する海外のスクレイピング API はありません。イランのサイトは外国の IP に非常に敏感です。イラン国外のプロキシ経由のリクエストは 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() | 有効なすべての Actor(サイト固有のスクレイパー)82 個と、それぞれの入力スキーマを一覧表示します。 |
run_actor(slug, input) | slug を指定して有効な Actor を実行します。以下に厳選して掲載したものだけでなく、82 個すべての Actor を呼び出す汎用的な方法です。 |
get_actor_run(run_id) | run_id とともに status: "processing" を返した、時間のかかる Actor の実行またはスクリーンショットの結果をポーリングまたは取得します。 |
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 とテキストの出力は無料です(上記のプロキシ/レンダリング料金に追加費用はかかりません)。失敗したリクエストの料金は返金されます。
リンク
- https://barchin.net/ai-agents
- https://barchin.net/en/ai-agents
- https://barchin.net/docs
- https://barchin.net/openapi.json
- https://barchin.net/llms.txt
- https://barchin.net/pricing
ライセンス
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 و متنی رایگان است (بدون هزینه اضافه نسبت به هزینه پراکسی/رندر بالا). درخواستهای ناموفق اعتبار برگشتی دارند.
لینکها
- https://barchin.net/ai-agents
- https://barchin.net/en/ai-agents
- https://barchin.net/docs
- https://barchin.net/openapi.json
- https://barchin.net/llms.txt
- https://barchin.net/pricing
مجوز
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。