# URL to Markdown API クイックスタート：2分で最初のページを取得

> URL to Markdown API クイックスタート：APIキーを取得し、curl、Python、Node.jsで最初のページを読み取り、クレジットを確認します。$0.07/1Kページから、KYC不要。

- URL: https://webreaderapi.com/ja/docs/
- 最終更新: 2026-10-22
- 発行者: WebReaderAPI (https://webreaderapi.com)

エンドポイントは1つ、パラメータも1つ：URLを`/read`に送ると、ページの本文がMarkdownで返ってきます。このページでは残高ゼロから実際に呼び出せる状態まで導き、その後ほかのすべての情報へ案内します。

**概要 — APIでURLをMarkdownに変換するには？**

URLを`Authorization`ヘッダーにAPIキーを付けて`GET https://webreaderapi.com/api/v1/read`に送ってください。**WebReaderAPI**がページを取得し、本文を保持して、タイトル、著者、日付、単語数とともにMarkdownとして返します。1ページにつき1クレジット（ブラウザが必要な場合は2クレジット）で、2026年10月時点では$0.07/1Kページから。KYC不要、暗号資産で支払い。

## APIの一覧表

| 項目 | 値 |
| --- | --- |
| ベースURL | `https://webreaderapi.com/api/v1` |
| 1ページを読み取る | `GET`または`POST https://webreaderapi.com/api/v1/read` |
| 複数のURLまたはサイト | `POST https://webreaderapi.com/api/v1/batch`と`POST https://webreaderapi.com/api/v1/crawl`、結果は`GET https://webreaderapi.com/api/v1/jobs/{job_id}`から |
| 残高クレジット | `GET https://webreaderapi.com/api/v1/credits`（無料） |
| 認証 | APIキーはAuthorizationヘッダーにBearerトークンとして、またはapi_keyクエリパラメータで送信してください |
| 課金 | 1クレジット = ブラウザなしでページを1回読み取り。ページのJavaScriptレンダリングにブラウザが必要な場合は2クレジット。失敗したリクエスト、またはサイトのrobots.txtが拒否したリクエストは課金されません |
| 当社のクローラー | `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)`、robots.txtトークン`WebReaderAPI` |
| 最小パック | $3.75で10,000ページ、クレジットは無期限 |

## APIキーはどう取得しますか？

3ステップで完了、記入するフォームはありません。最も時間がかかるのは、チャージ分のブロックチェーン確認です。

1. **暗号資産でチャージ** — BTC, USDT, USDC, ETH, SOL, LTCで$25以上を送金してください。アカウント番号でログイン。メールは任意。
2. **クレジットパックを購入する** — $3.75あたり10,000ページあれば、ご自身のURLで全オプションを試せます。
3. **APIキーをコピー** — 暗号資産でのチャージが確認され、パックを購入すると、ダッシュボードでAPIキーが使用可能になります。WEBREADER_API_KEYという名前の環境変数に保存してください。

## 最初のリクエストはどのような形ですか？

ページアドレスを`url`パラメータに入れた、シンプルなHTTPS GETです。アドレスには`:`や`/`の文字が含まれるため、エンコードしてください。curlでは`--data-urlencode`を付ければ自動で処理されます。デフォルト設定はほとんどの記事やドキュメントページにそのまま適しています。Markdown出力、本文のみ、そしてページに必要な場合のみブラウザを使用します。

*curl: 1ページを読み取る*

```bash
curl -sG "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/blog/first-post"
```

*Python: 1ページを読み取って保存する*

```python
import os

import requests

resp = requests.get(
    "https://webreaderapi.com/api/v1/read",
    headers={"Authorization": "Bearer " + os.environ["WEBREADER_API_KEY"]},
    params={"url": "https://example.com/blog/first-post"},
    timeout=70,
)
resp.raise_for_status()
page = resp.json()
print(page["title"], "-", page["word_count"], "words,", page["credits_used"], "credit(s)")
with open("first-post.md", "w", encoding="utf-8") as f:
    f.write(page["markdown"])

```

*Node.js 18+: 1ページを読み取る*

```javascript
const params = new URLSearchParams({ url: 'https://example.com/blog/first-post' });
const res = await fetch(`https://webreaderapi.com/api/v1/read?${params}`, {
  headers: { Authorization: `Bearer ${process.env.WEBREADER_API_KEY}` },
});
const page = await res.json();
if (!res.ok) throw new Error(`${page.error.code}: ${page.error.message}`);
console.log(page.title, page.word_count, 'words');
console.log(page.markdown.slice(0, 500));

```

## 何が返ってきますか？

`markdown`フィールドにMarkdown、その隣にページのメタデータを含むJSONオブジェクトです: `title`、`description`、`author`、`published_at`、`language`、`site_name`、`word_count`。何が起きたかを確認できるフィールドが2つあります: `final_url`はリダイレクト後のアドレス、`rendered`はブラウザが必要だったかどうかを示します。

`credits_used`は呼び出しのコストを示します: 通常のページは1、`rendered`が`true`のときは2、`country`を選んだ場合はさらに1。 [response format](https://webreaderapi.com/ja/docs/response/)ページには全フィールドが例付きで掲載されています。

## どのオプションを最もよく使いますか？

5つのパラメータでほとんどのニーズをカバーできます。すべて任意です。

| パラメータ | 用途 |
|---|---|
| `format` | `markdown`の代わりに`text`やクリーンアップした`html`を取得 |
| `main_content` | `false`を設定してメニューを含むページ全体を変換 |
| `render` | ブラウザを強制（`true`）または禁止（`false`）。`auto`が自動判断 |
| `include_links` | ページのリンクを別リストとして取得 |
| `max_chars` | 長いページをモデルのコンテキスト予算に収まるようカット |

[read reference](https://webreaderapi.com/ja/docs/read/)には`country`、`include_images`、`timeout`を含む全パラメータが記載されています。

## 残りのクレジットはどう確認しますか？

同じキーで`GET https://webreaderapi.com/api/v1/credits`を呼び出してください。`credits_remaining`、`credits_used_today`、`concurrency_limit`を返し、コストはかかりません。長時間のジョブの開始時に実行すれば、途中で`402 insufficient_credits`により失敗するのではなく、クリーンに停止できます。

プリペイドクレジットに有効期限はありません。未使用のページは使うまでアカウントに残りますため、あるプロジェクト用に購入したパックは次のプロジェクトでもその価値を保ちます。

## サイトがrobotsを許可していない場合はどうなりますか？

ページを読み取らず、課金もされません。当社のクローラーは`WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)`として名乗り、サイトのrobots.txtに従います。許可されていないページには`403 blocked_by_robots`を返し、別の方法でリクエストを拒否するサイトにはそのサイト自身のステータスコードとともに`502 target_refused`を返します。

サイトが当社のリクエストを拒否した場合、その回答をそのまま返します。CAPTCHAを解いたり、アカウントにログインしたり、ブロックやペイウォールを回避しようとしたりすることは決してありません。[errors page](https://webreaderapi.com/ja/docs/errors/)では、再試行すべきエラーと最終的なエラーを説明しています。

## 次に何をすればよいですか？

- [endpoint referenceを読む](https://webreaderapi.com/ja/docs/read/) — /readの全パラメータと例
- [バッチとクロール](https://webreaderapi.com/ja/docs/crawl/) — バッチあたり最大100 URL、またはサイト全体
- [レスポンス形式](https://webreaderapi.com/ja/docs/response/) — レスポンスの全フィールド
- [エラーとrobots.txt](https://webreaderapi.com/ja/docs/errors/) — コード、原因、再試行ルール
- [Python](https://webreaderapi.com/ja/docs/python/) — requests、async httpx、RAGチャンキング
- [Node.js](https://webreaderapi.com/ja/docs/node/) — fetch、小さなプール、クロールのポーリング
- [curlとjq](https://webreaderapi.com/ja/docs/curl/) — ターミナル向けレシピ
- [MCPサーバー](https://webreaderapi.com/ja/docs/mcp/) — ClaudeとCursor向けのread_urlツール
- [LangChainとLlamaIndex](https://webreaderapi.com/ja/docs/langchain/) — RAG向けのローダーとツール
- [OpenAI function calling](https://webreaderapi.com/ja/docs/openai/) — read_urlツールのスキーマとループ
- [n8n](https://webreaderapi.com/ja/docs/n8n/) — AI Agent向けHTTP Requestツール
- [OpenClaw](https://webreaderapi.com/ja/docs/openclaw/) — web_fetchの隣にMCPサーバーを追加

## クイックスタート: よくある質問

### インストールするSDKはありますか？

いいえ。WebReaderAPIはシンプルなHTTPS APIなので、どのHTTPクライアントでも動作します。ドキュメントにはPython、Node.js、curl向けのコピー&ペースト用コードと、MCP、LangChain、LlamaIndex、OpenAI function calling向けのツール定義が掲載されています。パッケージとして公開されているものはありません。

### キーをヘッダーではなくURLで送れますか？

はい、`api_key`クエリパラメータとして送れます。`Authorization: Bearer`ヘッダーの方が安全です。URLはログやブラウザ履歴に残ることが多いためです。APIキーは複数作成できます（例：エージェントやプロジェクトごとに1つ）。ダッシュボードからいつでも失効できます。

### 失敗したページでクレジットは消費されますか？

いいえ。1クレジット = ブラウザなしでページを1回読み取り。ページのJavaScriptレンダリングにブラウザが必要な場合は2クレジット。失敗したリクエスト、またはサイトのrobots.txtが拒否したリクエストは課金されません。コンテンツが返ってきたページのみ課金されます。

### 購入前に試せますか？

無料枠はありません。無料プランはありません。最小パックがテスト手段で、最低チャージ額から支払います。最低チャージ額に到達するためだけに追加した金額は、未使用であれば30日以内にリクエストによりUSDTまたはUSDCで返金できます。

---

WebReaderAPI: WebReaderAPIはAIエージェント向けのWebリーダーAPIで、あらゆる公開WebページをクリーンなMarkdownに変換します。暗号資産で支払い、本人確認書類のアップロードは不要です。$0.07/1Kページから購入できるプリペイドクレジットに有効期限はなく、robots.txtを尊重します。KYC不要 — 身分証もセルフィーも書類も不要。暗号資産で支払い。