🛠️ 開発・MCP コミュニティ 🔴 エンジニア向け 👤 エンジニア・AI開発者

🛠️ Mrscraper

mrscraper

AIを活用し、ブロックされにくい形でウェブサイトから必要な

⚡ ⏱ テスト計画作成 2時間 → 20分

📜 元の英語説明(参考)

Run AI-powered, unblockable web scraping, data extraction with natural language via the MrScraper API

🇯🇵 日本人クリエイター向け解説

一言でいうと

AIを活用し、ブロックされにくい形でウェブサイトから必要な

※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。

⚡ おすすめ: コマンド1行でインストール(60秒)

下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。ダウンロード → 解凍 → 配置まで全自動。

🍎 Mac / 🐧 Linux

mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o mrscraper.zip https://jpskill.com/download/5077.zip && unzip -o mrscraper.zip && rm mrscraper.zip

🪟 Windows (PowerShell)

$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/5077.zip -OutFile "$d\mrscraper.zip"; Expand-Archive "$d\mrscraper.zip" -DestinationPath $d -Force; ri "$d\mrscraper.zip"

完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。

💾 手動でダウンロードしたい(コマンドが難しい人向け)

1. 下の青いボタンを押して mrscraper.zip をダウンロード
2. ZIPファイルをダブルクリックで解凍 → mrscraper フォルダができる
3. そのフォルダを C:\Users\あなたの名前\.claude\skills\(Win)または ~/.claude/skills/(Mac)へ移動
4. Claude Code を再起動

⬇ .zip でダウンロード(推奨) ⬇ .skill 形式(上級者用) 元のソース ↗

⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。

🎯 このSkillでできること

下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。

📦 インストール方法 (3ステップ)

1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
3. 展開してできたフォルダを、ホームフォルダの .claude/skills/ に置く
- · macOS / Linux: ~/.claude/skills/
- · Windows: %USERPROFILE%\.claude\skills\

Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。

詳しい使い方ガイドを見る →

最終更新: 2026-05-17
取得日時: 2026-05-18
同梱ファイル: 1

💬 こう話しかけるだけ — サンプルプロンプト

› Mrscraper を使って、最小構成のサンプルコードを示して
› Mrscraper の主な使い方と注意点を教えて
› Mrscraper を既存プロジェクトに組み込む方法を教えて

これをClaude Code に貼るだけで、このSkillが自動発動します。

📖 Skill本文(日本語訳)

※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。

MrScraper

MrScraper API を介して、AI を活用した、ブロックされないウェブスクレイピングと自然言語によるデータ抽出を実行します。

アクション

このスキルは以下をサポートしています。

アンブロッカー（ステルスブラウザ + IP ローテーション）によるブロックされたページのオープン
自然言語の指示による AI スクレイパーの実行開始
既存のスクレイパー設定を 1 つまたは複数の URL で再実行
手動ワークフローベースの再実行の実行
ページ分割された結果と詳細な結果を ID で取得

このスキルは API のみであり、バンドルされたローカルスクリプトには依存しません。

ベース URL

アンブロッカー API: https://api.mrscraper.com
プラットフォーム API: https://api.app.mrscraper.com

認証

アンブロッカー API 認証

アンブロッカーエンドポイントでクエリパラメータ認証を使用します。

token=<MRSCRAPER_API_TOKEN>

プラットフォーム API 認証

プラットフォームエンドポイントでヘッダーベースの認証を使用します。

x-api-token: <MRSCRAPER_API_TOKEN>
accept: application/json
content-type: application/json

`MRSCRAPER_API_TOKEN` の取得方法

API トークンを使用すると、アプリケーションは MrScraper API と安全にやり取りし、ダッシュボードで作成されたスクレイパーを再実行できます。

ダッシュボードで以下の手順を実行してください。

右上隅にある User Profile をクリックします。
API Tokens を選択します。
New Token をクリックします。
名前を入力し、有効期限を設定します。
Create をクリックします。
新しいトークンをコピーし、MRSCRAPER_API_TOKEN として安全に保存します。
x-api-token ヘッダーを介してリクエストで使用します。

セキュリティルール:

クライアントサイドコード（ブラウザ/モバイルアプリバンドル）でトークンを公開しないでください。
トークンは環境変数またはサーバーサイドのシークレットマネージャーに保存してください。

認証ドキュメントからの注意事項:

API キーはすべての V3 プラットフォームエンドポイントで機能します。
同じキーを sync.scraper.mrscraper.com のエンドポイントでも使用できます。
他のホストのエンドポイントへのアクセスについては、support@mrscraper.com にお問い合わせください。

インストールとランタイム

このスキルドキュメントでは、ローカルインストール手順は不要です。
バンドルされた scripts/ は不要です。
呼び出しは、上記の 2 つのベース URL への直接 HTTPS リクエストです。

データとスコープ

データは api.app.mrscraper.com と api.mrscraper.com にのみ送信されます。
レスポンスには、抽出されたページコンテンツとスクレイプメタデータが含まれる場合があります。
このスキルは、隠れた永続性やバックグラウンドジョブを定義しません。
ログ、コミット、または出力でトークンを公開しないでください。

エンドポイント

1. アンブロッカー

メソッド: GET
URL: https://api.mrscraper.com
認証: token クエリパラメータ

ステルスブラウジングと IP ローテーションを介してターゲット URL を開き、HTML を返します。キャプチャやアンチボット保護によって直接アクセスがブロックされている場合に使用します。

クエリパラメータ:

フィールド	タイプ	必須	デフォルト	説明
`token`	`string`	はい	—	アンブロッカートークン (`MRSCRAPER_API_TOKEN`)
`url`	`string`	はい	—	URL エンコードされたターゲット URL
`timeout`	`number`	いいえ	60	最大待機時間（秒単位、例 `120`）
`geoCode`	`string`	いいえ	なし	地域ルーティングコード（例 `SG`）
`blockResources`	`boolean`	いいえ	false	不要なリソースをブロックするかどうか

リクエスト例:

curl --location 'https://api.mrscraper.com?token=<MRSCRAPER_API_TOKEN>&timeout=120&geoCode=SG&url=https%3A%2F%2Fwww.lazada.sg%2Fproducts%2Fpdp-i111650098-s23209659764.html&blockResources=false'

レスポンス例:

<!doctype html>
<html>
  <head>...</head>
  <body>...</body>
</html>

注意事項:

再現性のある動作のために、明示的な geoCode と実用的なタイムアウトを推奨します。
セッション固有のコンテンツが必要な場合にのみクッキーを渡してください。

2. AI スクレイパーの作成

メソッド: POST
ホスト: https://api.app.mrscraper.com
パス: /api/v1/scrapers-ai
認証: x-api-token

自然言語の指示から新しい AI スクレイパーの実行を作成します。

ペイロードパラメータ（`agent`: `general` または `agent`: `listing` の場合）:

フィールド	タイプ	必須	デフォルト	説明
`url`	string	はい	—	ターゲット URL
`message`	string	はい	—	抽出指示
`agent`	string	いいえ	general	スクレイピングに使用する AI エージェントのタイプ: `general`、`listing`、または `map`
`proxyCountry`	string	いいえ	なし	プロキシベースのスクレイピングに使用する ISO 国コード

ペイロードパラメータ（`agent`: `map` の場合）:

フィールド	タイプ	必須	デフォルト	説明
`url`	`string`	はい	—	ターゲット URL
`agent`	`string`	いいえ	map	スクレイピングに使用する AI エージェントのタイプ（この場合は `map`）
`maxDepth`	`number`	いいえ	2	開始 URL からリンクをクロールする最大深度レベル。<br>0 = 開始 URL のみ、1 = +直接リンク
`maxPages`	`number`	いいえ	50	クロールプロセス中にスクレイピングする最大ページ数。
`limit`	`number`	いいえ	1000	すべてのページから抽出する最大データレコード数。この制限に達するとスクレイピングは停止します。
`includePatterns`	`string`	いいえ	""	含める正規表現パターン（複数ある場合は `\\|\\|` で区切る）

📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開

MrScraper

Run AI-powered, unblockable web scraping, data extraction with natural language via the MrScraper API

Actions

This skill supports:

Opening blocked pages through unblocker (stealth browser + IP rotation)
Starting AI scraper runs from natural-language instructions
Rerunning existing scraper configurations on one or multiple URLs
Running manual workflow-based reruns
Fetching paginated results and detailed results by ID

This skill is API-only and does not depend on bundled local scripts.

Base URLs

Unblocker API: https://api.mrscraper.com
Platform API: https://api.app.mrscraper.com

Authentication

Unblocker API auth

Use query-param auth on unblocker endpoint:

token=<MRSCRAPER_API_TOKEN>

Platform API auth

Use header-based auth on platform endpoints:

x-api-token: <MRSCRAPER_API_TOKEN>
accept: application/json
content-type: application/json

How to get `MRSCRAPER_API_TOKEN`?

An API token lets your applications securely interact with MrScraper APIs and rerun scrapers created in the dashboard.

Follow these steps in the dashboard:

Click your User Profile at the top-right corner.
Select API Tokens.
Click New Token.
Enter a name and set an expiration date.
Click Create.
Copy the new token and store it securely as MRSCRAPER_API_TOKEN.
Use it in requests through the x-api-token header.

Security rule:

Never expose tokens in client-side code (browser/mobile app bundles).
Store tokens in environment variables or server-side secret managers.

Notes from the auth docs:

The API key works for all V3 Platform endpoints.
The same key can be used for endpoints on sync.scraper.mrscraper.com.
For access to endpoints on other hosts, contact support@mrscraper.com.

Install and Runtime

No local install step is required by this skill document.
No bundled scripts/ are required.
Calls are direct HTTPS requests to the two base URLs above.

Data and Scope

Data is sent only to api.app.mrscraper.com and api.mrscraper.com.
Responses may contain extracted page content and scrape metadata.
This skill does not define hidden persistence or background jobs.
Never expose tokens in logs, commits, or output.

Endpoints

1. Unblocker

Method: GET
URL: https://api.mrscraper.com
Auth: token query parameter

Opens a target URL through stealth browsing and IP rotation, then returns HTML. Use this when direct access is blocked by captcha or anti-bot protections.

Query parameters:

Field	Type	Required	Default	Description
`token`	`string`	Yes	—	Unblocker token (`MRSCRAPER_API_TOKEN`)
`url`	`string`	Yes	—	URL-encoded target URL
`timeout`	`number`	No	60	Max wait in seconds (example `120`)
`geoCode`	`string`	No	None	Geographic routing code (example `SG`)
`blockResources`	`boolean`	No	false	Block non-essential resources

Request example:

curl --location 'https://api.mrscraper.com?token=<MRSCRAPER_API_TOKEN>&timeout=120&geoCode=SG&url=https%3A%2F%2Fwww.lazada.sg%2Fproducts%2Fpdp-i111650098-s23209659764.html&blockResources=false'

Response example:

<!doctype html>
<html>
  <head>...</head>
  <body>...</body>
</html>

Notes:

Prefer explicit geoCode and practical timeouts for repeatable behavior.
Only pass cookies when session-specific content is required.

2. Create AI Scraper

Method: POST
Host: https://api.app.mrscraper.com
Path: /api/v1/scrapers-ai
Auth: x-api-token

Create a new AI scraper run from natural-language instructions.

Payload parameters (for `agent`: `general` or `agent`: `listing`):

Field	Type	Required	Default	Description
`url`	string	Yes	—	Target URL
`message`	string	Yes	—	Extraction instruction
`agent`	string	No	general	The AI agent type to use for scraping: `general`, `listing`, or `map`
`proxyCountry`	string	No	None	ISO country code for proxy-based scraping

Payload parameters (for `agent`: `map`):

Field	Type	Required	Default	Description
`url`	`string`	Yes	—	Target URL
`agent`	`string`	No	map	The AI agent type to use for scraping (for this case it is `map`)
`maxDepth`	`number`	No	2	Maximum depth level for crawling links from the starting URL.<br>0 = only the starting URL, 1 = +direct links
`maxPages`	`number`	No	50	Maximum number of pages to scrape during the crawling process.
`limit`	`number`	No	1000	Maximum number of data records to extract across all pages. Scraping stops when this limit is reached.
`includePatterns`	`string`	No	""	Regex patterns to include (separate multiple with `\\|\\|`)
`excludePatterns`	`string`	No	""	Regex patterns to exclude (separate multiple with `\\|\\|`)

Request example:

curl -X POST "https://api.app.mrscraper.com/api/v1/scrapers-ai" \
  -H "x-api-token: <MRSCRAPER_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
    "message": "Extract title, price, stocks, and rating",
    "agent": "general"
  }'

Response example:

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "createdAt": "2019-08-24T14:15:22Z",
  "createdById": "e13e432a-5323-4484-a91d-b5969bc564d9",
  "updatedAt": "2019-08-24T14:15:22Z",
  "updatedById": "d8bc6076-4141-4a88-80b9-0eb31643066f",
  "deletedAt": "2019-08-24T14:15:22Z",
  "deletedById": "8ef578ad-7f1e-4656-b48b-b1b4a9aaa1cb",
  "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
  "scraperId": "6695bf87-aaa6-46b0-b1ee-88586b222b0b",
  "type": "AI",
  "url": "http://example.com",
  "status": "Finished",
  "error": "string",
  "tokenUsage": 0,
  "runtime": 0,
  "data": {}, // MAIN SCRAPED DATA
  "htmlPath": "string",
  "recordingPath": "string",
  "screenshotPath": "string",
  "dataPath": "string"
}

Notes:

Choose agent type correctly as each agent is specialized for specified use cases. Use general for most standard web scraping tasks. The go to agent if the user doesn't specify or the connected LLM is not confident about the type of page. But mostly used for scraping product page, but handles any type of page very well as well. Use listing for scraping listing pages like product listings, job listings, etc. Choose this if the connected LLM can confidently identify whether the given URL is a listing page. Use map for crawling and getting all subdomain or subpages of a website. Choose this if the user specifies that the given URL is a website and not a specific page. For map agent type, there is a special args that can be used to configure the scraping process.
For the map agent, you can use special arguments to control crawling: maxDepth (lower values 1–2 for focused scraping, max 3 recommended), maxPages (limits total pages regardless of depth), limit (caps total records extracted), and includePatterns/excludePatterns (regex patterns separated by || to specify which URLs to crawl or skip, e.g., */products/*||*/blog/* or */cart/*||*.pdf). If includePatterns is an empty string, all URLs are included. If excludePatterns is an empty string, no URLs are excluded.

3. Rerun AI Scraper

Method: POST
Host: https://api.app.mrscraper.com
Path: /api/v1/scrapers-ai-rerun
Auth: x-api-token

Reruns an existing scraper configuration on a new URL.

Payload parameters:

Field	Type	Required	Default	Description
`scraperId`	`string`	Yes	—	Scraper ID retrieved from created AI scraper
`url`	`string`	Yes	—	Target URL

Optional payload parameters for `map` agent:

Field	Type	Required	Default	Description
`maxDepth`	number	No	2	Crawl depth
`maxPages`	number	No	50	Maximum pages to crawl
`limit`	number	No	1000	Result limit
`includePatterns`	string	No	""	Regex patterns to include (separate multiple with `\\|\\|`)
`excludePatterns`	string	No	""	Regex patterns to exclude (separate multiple with `\\|\\|`)

Request example:

curl -X POST "https://api.app.mrscraper.com/api/v1/scrapers-ai-rerun" \
  -H "accept: application/json" \
  -H "x-api-token: <MRSCRAPER_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "scraperId": "6695bf87-aaa6-46b0-b1ee-88586b222b0b",
    "url": "https://shopee.sg/"
  }'

Response example:

{
  "message": "Successful operation!",
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "createdAt": "2019-08-24T14:15:22Z",
    "createdById": "e13e432a-5323-4484-a91d-b5969bc564d9",
    "updatedAt": "2019-08-24T14:15:22Z",
    "updatedById": "d8bc6076-4141-4a88-80b9-0eb31643066f",
    "deletedAt": "2019-08-24T14:15:22Z",
    "deletedById": "8ef578ad-7f1e-4656-b48b-b1b4a9aaa1cb",
    "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
    "scraperId": "6695bf87-aaa6-46b0-b1ee-88586b222b0b",
    "type": "Rerun-AI",
    "url": "http://example.com",
    "status": "Finished",
    "error": "string",
    "tokenUsage": 0,
    "runtime": 0,
    "data": {}, // MAIN SCRAPED DATA
    "htmlPath": "string",
    "recordingPath": "string",
    "screenshotPath": "string",
    "dataPath": "string",
    "htmlContent": "string"
  }
}

4. Bulk Rerun AI Scraper

Method: POST
Host: https://api.app.mrscraper.com
Path: /api/v1/scrapers-ai-rerun/bulk
Auth: x-api-token

Runs one scraper configuration over multiple URLs.

Payload parameters:

Field	Type	Required	Default	Description
`scraperId`	`string`	Yes	—	Existing AI scraper configuration ID
`urls`	`array[string]`	Yes	—	Target URLs to run

Request example:

curl -X POST "https://api.app.mrscraper.com/api/v1/scrapers-ai-rerun/bulk" \
  -H "x-api-token: " \
  -H "Content-Type: application/json" \
  -d '{
    "scraperId": "6695bf87-aaa6-46b0-b1ee-88586b222b0b",
    "urls": [
      "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
      "https://books.toscrape.com/catalogue/tipping-the-velvet_999/index.html",
      "https://books.toscrape.com/catalogue/soumission_998/index.html"
    ]
  }'

Response example:

{
  "message": "Bulk rerun started successfully",
  "data": {
    "bulkResultId": "f89f8f58-3c9a-42e5-a72e-59fa6c389f09",
    "status": "Running",
    "totalUrls": 3
  }
}

5. Rerun Manual Scraper

Method: POST
Host: https://api.app.mrscraper.com
Path: /api/v1/scrapers-manual-rerun
Auth: x-api-token

Executes a rerun using a manual browser workflow.

Creating a Manual Scraper

Before calling the manual rerun endpoint, you need to create and save a manual scraper from the dashboard. Follow these steps:

Open the MrScraper dashboard and go to Scraper.
Click New Manual Scraper +.
Enter your target URL.
Add workflow steps that match your site's behavior (e.g., Input, Click, Delay, Extract, Inject JavaScript).
Configure pagination if needed (using options like Query Pagination, Directory Pagination, or Next Page Link).
Test and save the scraper, then copy its scraperId to use in API reruns.

Payload parameters:

Field	Type	Required	Default	Description
`scraperId`	`string`	Yes	—	ID of the manual scraper to rerun.
`url`	`string`	Yes	—	Target URL for the rerun.
`workflow`	`array<object>`	No	None	Allows overriding the saved workflow steps. By default, uses the workflow saved during manual creation.

Request example:

curl -X POST "https://api.app.mrscraper.com/api/v1/scrapers-manual-rerun" \
  -H "accept: application/json" \
  -H "x-api-token: " \
  -H "Content-Type: application/json" \
  -d '{
    "scraperId": "6695bf87-aaa6-46b0-b1ee-88586b222b0b",
    "url": "https://books.toscrape.com/",
    "workflow": [
      {
        "type": "extract",
        "data": {
          "extraction_type": "text",
          "attribute": null,
          "name": "book",
          "selector": "h3 a"
        }
      }
    ],
    "record": false,
    "paginator": {
      "type": "query_pagination",
      "max_page": 1,
      "enabled": false
    }
  }'

Response example:

{
  "message": "Successful operation!",
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "createdAt": "2019-08-24T14:15:22Z",
    "createdById": "e13e432a-5323-4484-a91d-b5969bc564d9",
    "updatedAt": "2019-08-24T14:15:22Z",
    "updatedById": "d8bc6076-4141-4a88-80b9-0eb31643066f",
    "deletedAt": "2019-08-24T14:15:22Z",
    "deletedById": "8ef578ad-7f1e-4656-b48b-b1b4a9aaa1cb",
    "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
    "scraperId": "6695bf87-aaa6-46b0-b1ee-88586b222b0b",
    "type": "Rerun-AI",
    "url": "http://example.com",
    "status": "Finished",
    "error": "string",
    "tokenUsage": 0,
    "runtime": 0,
    "data": {}, // MAIN SCRAPED DATA
    "htmlPath": "string",
    "recordingPath": "string",
    "screenshotPath": "string",
    "dataPath": "string",
    "htmlContent": "string"
  }
}

6. Bulk Rerun Manual Scraper

Method: POST
Host: https://api.app.mrscraper.com
Path: /api/v1/scrapers-manual-rerun/bulk
Auth: x-api-token

Runs one scraper configuration over multiple URLs.

Payload parameters:

Field	Type	Required	Default	Description
`scraperId`	`string`	Yes	—	Existing manual scraper configuration ID
`urls`	`array[string]`	Yes	—	Target URLs to run

Request example:

curl -X POST "https://api.app.mrscraper.com/api/v1/scrapers-manual-rerun/bulk" \
  -H "x-api-token: " \
  -H "Content-Type: application/json" \
  -d '{
    "scraperId": "6695bf87-aaa6-46b0-b1ee-88586b222b0b",
    "urls": [
      "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
      "https://books.toscrape.com/catalogue/tipping-the-velvet_999/index.html",
      "https://books.toscrape.com/catalogue/soumission_998/index.html"
    ]
  }'

Response example:

{
  "message": "Bulk rerun started successfully",
  "data": {
    "bulkResultId": "f89f8f58-3c9a-42e5-a72e-59fa6c389f09",
    "status": "Running",
    "totalUrls": 3
  }
}

7. Fetch Results

Method: GET
Host: https://api.app.mrscraper.com
Path: /api/v1/results
Auth: x-api-token

Returns paginated scrape results.

Query parameters:

Field	Type	Required	Default	Description
`sortField`	string	Yes	`updatedAt`	Sort column
`sortOrder`	string	Yes	`DESC`	Sort direction
`page`	number	Yes	1	Page number
`pageSize`	number	Yes	10	Items per page
`search`	string	No	None	Search keyword
`dateRangeColumn`	string	No	`createdAt`	Date field to filter
`startAt`	string	No	None	Date range start (ISO)
`endAt`	string	No	None	Date range end (ISO)

Notes:

sortField options: createdAt, updatedAt, id, type, url, status, error, tokenUsage, runtime
sortOrder options: ASC, DESC
dateRangeColumn options: createdAt, updatedAt

Request example:

curl -X GET "https://api.app.mrscraper.com/api/v1/results?sortField=updatedAt&sortOrder=DESC&pageSize=10&page=1" \
  -H "accept: application/json" \
  -H "x-api-token: <MRSCRAPER_API_TOKEN>"

Response example:

{
  "message": "Successful fetch",
  "data": [
    {
      "createdAt": "2025-11-11T09:50:09.722Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
      "scraperId": "6695bf87-aaa6-46b0-b1ee-88586b222b0b",
      "type": "AI",
      "url": "http://example.com",
      "status": "Finished",
      "error": "string",
      "tokenUsage": 5,
      "runtime": 0,
      "data": "{ \"title\": \"Product A\", \"price\": \"$10\" }",
      "htmlPath": "string",
      "recordingPath": "string",
      "screenshotPath": "string",
      "dataPath": "string"
    }
  ],
  "meta": {
    "page": 1,
    "pageSize": 10,
    "total": 1,
    "totalPage": 1
  }
}

8. Fetch Detailed Result by ID

Method: GET
Host: https://api.app.mrscraper.com
Path: /api/v1/results/{id}
Auth: x-api-token

Returns one detailed result object for a specific result ID.

Query parameters:

Field	Type	Required	Default	Description
`id`	`string`	Yes	—	Result ID

Request example:

curl -X GET "https://api.app.mrscraper.com/api/v1/results/497f6eca-6276-4993-bfeb-53cbbbba6f08" \
  -H "accept: application/json" \
  -H "x-api-token: <MRSCRAPER_API_TOKEN>"

Response example:

{
  "message": "Successful fetch",
  "data": [
    {
      "createdAt": "2025-11-11T09:50:09.722Z",
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
      "scraperId": "6695bf87-aaa6-46b0-b1ee-88586b222b0b",
      "type": "AI",
      "url": "http://example.com",
      "status": "Finished",
      "error": "string",
      "tokenUsage": 5,
      "runtime": 0,
      "data": "string",
      "htmlPath": "string",
      "recordingPath": "string",
      "screenshotPath": "string",
      "dataPath": "string"
    }
  ]
}

Errors

Standard platform API errors:

Status	Meaning
`400`	Invalid request payload
`401`	Missing or invalid API token
`404`	Scraper or result not found
`429`	Rate limit exceeded
`500`	Internal scraper error

Error format:

{
  "message": "string",
  "error": "string",
  "statusCode": "number"
}

Operating Rules

Validate required fields before every call.
Use pagination for large result sets.
Retry on 429 with exponential backoff.
Never expose credentials in outputs.

🛠️ Mrscraper

🇯🇵 日本人クリエイター向け解説

🎯 このSkillでできること

📦 インストール方法 (3ステップ)

💬 こう話しかけるだけ — サンプルプロンプト

📖 Skill本文(日本語訳)

MrScraper

アクション

ベース URL

認証

アンブロッカー API 認証

プラットフォーム API 認証

MRSCRAPER_API_TOKEN の取得方法

インストールとランタイム

データとスコープ

エンドポイント

1. アンブロッカー

クエリパラメータ:

リクエスト例:

レスポンス例:

注意事項:

2. AI スクレイパーの作成

ペイロードパラメータ（agent: general または agent: listing の場合）:

ペイロードパラメータ（agent: map の場合）:

MrScraper

Actions

Base URLs

Authentication

Unblocker API auth

Platform API auth

How to get MRSCRAPER_API_TOKEN?

Install and Runtime

Data and Scope

Endpoints

1. Unblocker

Query parameters:

Request example:

Response example:

Notes:

2. Create AI Scraper

Payload parameters (for agent: general or agent: listing):

Payload parameters (for agent: map):

Request example:

Response example:

Notes:

3. Rerun AI Scraper

Payload parameters:

Optional payload parameters for map agent:

Request example:

Response example:

4. Bulk Rerun AI Scraper

Payload parameters:

Request example:

Response example:

5. Rerun Manual Scraper

Creating a Manual Scraper

Payload parameters:

Request example:

Response example:

6. Bulk Rerun Manual Scraper

Payload parameters:

Request example:

Response example:

7. Fetch Results

Query parameters:

Notes:

Request example:

Response example:

8. Fetch Detailed Result by ID

Query parameters:

Request example:

Response example:

Errors

Operating Rules

`MRSCRAPER_API_TOKEN` の取得方法

ペイロードパラメータ（`agent`: `general` または `agent`: `listing` の場合）:

ペイロードパラメータ（`agent`: `map` の場合）:

How to get `MRSCRAPER_API_TOKEN`?

Payload parameters (for `agent`: `general` or `agent`: `listing`):

Payload parameters (for `agent`: `map`):

Optional payload parameters for `map` agent: