# net.barchin/mcp

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

- name: net.barchin/mcp
- version: 1.0.0
- connection class: R1 (autonomous)
- trust: 93/100
- quality: 76/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/net.barchin%2Fmcp
- tools: https://api.protogrid.dev/v1/servers/net.barchin%2Fmcp/tools

**An agent can connect on its own if it already holds `BARCHIN_TOKEN`.** Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "barchin": {
      "type": "http",
      "url": "https://barchin.net/mcp",
      "headers": {
        "Authorization": "Bearer ${BARCHIN_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${BARCHIN_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 75
- drivers: +repository +dns-namespace +reachable +uptime-100% +updated-14d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 76/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 64 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_balance (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_scrape (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_screenshot (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- warn `tools.token_cost`: about 14,400 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 5 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 17, about 14,400 tokens to load them all
- tool set hash: a3a17e3cc662e3fb031faf99a394b0ba
- tools last changed: 2026-10-19T18:10:05.284Z
- badge: [![protogrid quality](https://protogrid.dev/badge/net.barchin/mcp.svg)](https://protogrid.dev/servers/net.barchin/mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-19 `actor_google-search` changed (inputSchema)
- 2026-10-19 `scrape_url` changed (inputSchema)
- 2026-10-12 `actor_divar-scraper` changed (inputSchema)
- 2026-10-10 `actor_torob-product-sellers` changed (inputSchema)
- 2026-10-09 `actor_torob-product-sellers` changed (inputSchema)

Full history: https://api.protogrid.dev/v1/servers/net.barchin%2Fmcp/changes

## Remotes

- https://barchin.net/mcp (streamable-http, auth api_key ${BARCHIN_TOKEN}, reachable true, uptime30d 1)

## Packages

_none_

## Tools (17)

- `actor_codal-scraper`: Barchin actor 'codal-scraper' (finance). اطلاعیه‌های ناشران بورسی را از کدال بگیرید: شماره‌ی پیگیری، نماد، نام شرکت، کد و عنوان اطلاعیه، زمان انتشار و ارسال (هم میلادی هم شمسی)، پایان دوره، حسابرسی‌شده و تلفیقی بودن، و پیوست‌های PDF و Excel. با parseTables جدول‌های خود گزارش هم استخراج می‌شوند. ⚠️ حسابرسی‌شده، تلفیقی و پایان دوره فقط در عن… Base fee 8 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.
- `actor_digikala-scraper`: Barchin actor 'digikala-scraper' (ecommerce). عبارت جست‌وجو، دسته‌بندی یا آدرس محصول را بدهید تا محصولات دیجی‌کالا را بگیرید: قیمت و تخفیف (به ریال)، موجودی، امتیاز، برند، مسیر دسته‌بندی، مشخصات فنی، رنگ‌ها و تصاویر. با گزینه‌های جداگانه فروشندگان، نظرها و پرسش‌وپاسخ هم به‌صورت ردیف‌های مستقل برمی‌گردند. نام نویسنده‌ی نظر و پرسش ذخیره نمی‌شود. Base fee 8 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.
- `actor_divar-scraper`: Barchin actor 'divar-scraper' (classifieds). شهر، دسته‌بندی یا عبارت جست‌وجو را بدهید تا آگهی‌های دیوار را بگیرید: عنوان، توضیحات، قیمت و ودیعه و اجاره، ویژگی‌ها (متراژ، سال ساخت، کارکرد و …)، تصاویر و موقعیت تقریبی. برای هر آگهی یک ردیف برمی‌گردد. شماره تلفن استخراج نمی‌شود، چون دیوار آن را پشت دکمه‌ی «نمایش شماره» نگه می‌دارد. Base fee 13 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.
- `actor_google-maps-scraper`: Barchin actor 'google-maps-scraper' (maps). عبارت جست‌وجو و محدوده‌ی مکانی را بدهید تا فهرست کسب‌وکارها را از گوگل‌مپس بگیرید: نام، دسته‌بندی، نشانی، تلفن، وب‌سایت، مختصات، امتیاز و تعداد نظر، ساعات کاری، امکانات، نظرها و تصاویر. ورودی و خروجی هم‌شکل اکتور compass/crawler-google-places در اپیفای است. برای هر مکان یک ردیف برمی‌گردد. Base fee 30 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.
- `actor_google-search`: Barchin actor 'google-search' (search). عبارت جست‌وجو را بدهید تا نتایج ارگانیک گوگل را به‌صورت JSON بگیرید: رتبه، عنوان، دامنه، نام سایت و متن توضیح. زبان و کشور نتایج قابل تنظیم است — پیش‌فرض فارسی و ایران. برای هر نتیجه یک ردیف برمی‌گردد. Base fee 40 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.
- `actor_persian-news-scraper`: Barchin actor 'persian-news-scraper' (news). اخبار ایسنا، ایرنا، تسنیم، خبرآنلاین، همشهری آنلاین، زومیت و دیجیاتو را با یک ساختار مشترک بگیرید: تیتر، لید، متن کامل (ساده یا مارک‌داون)، نویسنده، سرویس، برچسب‌ها، تصویر و زمان انتشار به هر دو تقویم. «انتهای پیام»، اخبار مرتبط، کد خبر و کپشن‌های تکراری از متن حذف می‌شوند. ⚠️ ایسنا، ایرنا و تسنیم ص… Base fee 30 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.
- `actor_sheypoor-scraper`: Barchin actor 'sheypoor-scraper' (marketplace). آگهی‌های شیپور را با شهر، دسته‌بندی، عبارت جست‌وجو یا آدرس مستقیم استخراج کنید: عنوان، توضیحات، قیمت، ودیعه و اجاره، ویژگی‌ها، تصاویر و موقعیت. خروجی دقیقاً هم‌شکل اکتور دیوار است تا بتوانید دو بازار را کنار هم بگذارید. ⚠️ شماره‌ی تماس در شیپور برای بازدیدکننده‌ی بدون حساب پوشانده می‌شود، پس استخراج… Base fee 8 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.
- `actor_tgju-price-scraper`: Barchin actor 'tgju-price-scraper' (finance). اسلاگ ابزار یا یک دسته‌ی کامل را بدهید تا نرخ لحظه‌ای طلا، سکه، ارز، رمزارز، نفت و فلزات را از TGJU بگیرید: نرخ، تغییر، درصد تغییر، بیشترین و کمترین روز و زمان به‌روزرسانی (میلادی و شمسی). با includeHistory تاریخچه‌ی روزانه هم برمی‌گردد. واحد نرخ از روی خود ابزار تعیین می‌شود — ابزارهای ایرانی ریال‌… Base fee 2 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.
- `actor_torob-product-sellers`: Barchin actor 'torob-product-sellers' (e-commerce). آدرس یک صفحه‌ی محصول در ترب (torob.com) را بدهید تا فهرست کامل فروشنده‌ها همراه با قیمت (تومان و ریال)، موجودی، امتیاز فروشگاه و لینک مستقیم هر فروشنده را دریافت کنید. قیمت‌های نامعتبر به‌صورت خودکار حذف می‌شوند. Base fee 20 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.
- `actor_tsetmc-scraper`: Barchin actor 'tsetmc-scraper' (finance). شش نوع داده از سرویس رسمی بورس تهران: وضعیت لحظه‌ای یک نماد، تاریخچه‌ی روزانه‌ی تعدیل‌شده، خرید و فروش حقیقی و حقوقی، عمق بازار، شاخص و دیده‌بان کل بازار. نماد فارسی خودش به insCode تبدیل می‌شود. ⚠️ همه‌ی قیمت‌ها به ریال است. ⚠️ خارج از ساعت معاملات، مقادیر لحظه‌ای صفر می‌شوند؛ اکتور در این حالت آخر… Base fee 8 credit(s) plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript). Call list_actors for the full input schema.
- `get_actor_run`: Check the status of a previous actor run (from an actor_<slug>, run_actor or get_screenshot call) and return its dataset once ready. Free: reading an already-paid-for result costs no credits.
- `get_balance`: Return the caller's remaining Barchin credit balance and a link to top up.
- `get_scrape`: Check the status of a previous scrape_url call and return its result — the content, in the requested format — once ready. Free: reading an already-paid-for result costs no credits. If the scrape is still running, returns a processing status to retry shortly.
- `get_screenshot`: Take a screenshot of a web page in a real browser through Barchin's proxies, and return it as a PNG image (first viewport, or the full scrolled page) or a PDF print of the page. Billed as an actor run: a base fee plus the proxy tier price for the one page it renders.
- `list_actors`: List Barchin's ready-made scrapers ('actors') for specific sites and data types (e.g. Instagram, Google Maps, e-commerce listings, business registries). Each entry's input_schema describes the arguments to pass as run_actor(slug, input); a curated set of featured actors also exists as its own direct actor_<slug> tool. Free to call — no credits are charged.
- `run_actor`: Run any Barchin actor by slug with its input object. Use list_actors to discover slugs and input schemas; featured actors also exist as direct actor_<slug> tools. Billed like the actor itself: base fee plus the proxy tier price per fetched page (datacenter 1, residential 15, unblocker 25, +5 with JavaScript).
- `scrape_url`: Fetch a web page through Barchin (rotating Iranian/datacenter proxies, optional JavaScript rendering, anti-bot handling) and return its content as Markdown, plain text or raw HTML. Costs credits: datacenter 1, residential 15, unblocker 25, +5 with JavaScript rendering; markdown/text conversion is free.