# API・MCP

[トップページ](https://iseeu.cc/ja/)に表示される情報を、すべてスクリプト、サーバー、AIエージェントから使えます。HTTPS対応、APIキー不要、登録不要、CORS有効で、フェアユースの範囲内なら商用でも無料です。

## 要点

`curl iseeu.cc`はグローバルIPアドレスと改行を出力します。`/json`はトップページに表示される内容すべてを1つのJSONオブジェクトで返し、`/mcp`は5つのツールを備えたModel Context Protocolサーバーです。IPアドレスごとに1分あたり60リクエスト以内（外部への問い合わせを伴う2つのエンドポイントは1分あたり10回以内）なら、無料で、キーも要りません。

### 調べ方

同じURLでも、リクエストに応じて返すものが変わります。text/htmlを求めるAcceptヘッダーにはWebページを、それ以外にはプレーンテキストを返します。JSONのエンドポイントは`?format=text`を付けると`key: value`形式の行で返し、text/plainを優先するAcceptヘッダーでも同じになります（コンテンツネゴシエーション、RFC 9110）。レスポンスはキャッシュされず、どのオリジンのスクリプトからでも読み取れます。MCPエンドポイントはStreamable HTTPで通信し、状態を持ちません。

### 例

```
$ curl iseeu.cc
192.0.2.1
$ curl -s "iseeu.cc/geo?format=text" | grep '^country:'
country: US
```

192.0.2.1と国は、ドキュメント用に予約された範囲（RFC 5737）から取ったプレースホルダーです。実際のリクエストでは、あなた自身の値が返ります。

### 制限事項

- データが表すのは、リクエストを送ったマシンです。クラウドで動くAIアシスタント経由なら、それはあなたではなく提供元のサーバーです。
- レート制限はCloudflareの拠点ごとに数えるので、おおよその値です。
- 地域のデータは、IPデータベースによる推定です。

### 出典

- [RFC 9110, section 12: Content Negotiation](https://www.rfc-editor.org/rfc/rfc9110#section-12)：Acceptヘッダーに応じた応答。
- [Model Context Protocol specification (2025-06-18)](https://modelcontextprotocol.io/specification/2025-06-18)：MCPのトランスポートとメッセージ。
- [OpenAPI Specification 3.1.0](https://spec.openapis.org/oas/v3.1.0)：/openapi.jsonの形式。
- [RFC 5737: IPv4 Address Blocks Reserved for Documentation](https://www.rfc-editor.org/rfc/rfc5737)：例に使っているアドレス。

## クイックスタート

以下の出力例では`192.0.2.1`を使っています。これはドキュメント用に予約されたアドレスで、実在の機器のものになることはありません。実際にコマンドを実行すると、あなた自身のIPが表示されます。

```
$ curl iseeu.cc
192.0.2.1

$ curl -s iseeu.cc/json | jq '{ip, country: .location.country, asn: .network.asn, tls: .tls.version}'
{
  "ip": "192.0.2.1",
  "country": "US",
  "asn": 7922,
  "tls": "TLSv1.3"
}
```

トップページのURLは、`Accept`ヘッダーを見て何を返すかを決めます。ブラウザは`text/html`を求めるのでページを受け取ります。curl、wget、HTTPie、PowerShell、各種HTTPライブラリはそうしないので、IPアドレスと改行だけの1行を受け取ります。

## エンドポイント

| パス | 返す内容 |
| --- | --- |
| / | あなたのIP（ブラウザ以外のクライアントにはプレーンテキスト）、またはWebページ（ブラウザ） |
| /ip | あなたのIP。常にプレーンテキスト |
| /json | すべて：IP、地域、ネットワーク、TLS、HTTP、解析済みのUser-Agent、リクエストヘッダー、サーバーの時刻 |
| /geo | IP、地域、ASN、組織名、Cloudflareのデータセンター |
| /tls | TLSのバージョン、暗号スイート、ClientHelloのサイズ、暗号スイートと拡張のハッシュ、HTTPのバージョン |
| /ua | あなたのUser-Agentを、ブラウザ、エンジン、OS、デバイス、クライアントの種類に分解したもの |
| /headers | あなたが送ったリクエストヘッダーと、Cloudflareが追加したヘッダー |
| /api/rdap?q= | ドメイン、IPアドレスまたはCIDR、AS番号のRDAP登録情報。IANAがそれぞれの問い合わせ先として載せているレジストリから取得し、要約と生のRDAP JSONを返します |
| /api/headers-check?url= | 公開URLのレスポンスヘッダー（リダイレクトはたどり、本文は読まない）とセキュリティの評価 |
| /mcp | MCPサーバー（Streamable HTTP、ステートレス）。詳しくは後述 |

特定のプロトコルのアドレスを見たいときは、curlで指定します。`curl -4 iseeu.cc`はIPv4アドレスを、`curl -6 iseeu.cc`はIPv6アドレスを表示します（マシンにIPv6の経路がなければ、すぐにエラーになります）。JSONでも同じように`curl -4 iseeu.cc/json`と`curl -6 iseeu.cc/json`が使えます。

JSONのエンドポイントに`?format=text`を付ける（または`Accept: text/plain`を送る）と、`key: value`形式の平らな行で返るので、`grep`と組み合わせるのに便利です。`format`に指定できるのは`json`か`text`だけで、それ以外の値には、黙って別の形式で返すのではなく、`"error": "invalid_format"`付きの`400`を返します。`curl "iseeu.cc/ua?format=text"`はUser-Agent文字列だけを表示します。機械が読める形式の仕様は[/openapi.json](https://iseeu.cc/openapi.json)（OpenAPI 3.1）にあります。

## /jsonのオブジェクト

レスポンスの例です（ここでも、予約済みの例示用アドレス`192.0.2.1`を使っています）。

```
{
  "ip": "192.0.2.1",
  "ipVersion": 4,
  "location": {
    "country": "US", "countryName": "United States",
    "region": "Texas", "regionCode": "TX", "city": "Austin",
    "postalCode": "78701", "metroCode": "635", "continent": "NA",
    "isEU": false, "latitude": 30.27, "longitude": -97.74,
    "timezone": "America/Chicago"
  },
  "network": { "asn": 7922, "asOrganization": "Comcast Cable", "colo": "DFW",
               "clientTcpRttMs": 22, "clientQuicRttMs": null, "deliveryRateBps": null },
  "tls": { "version": "TLSv1.3", "cipher": "AEAD-AES128-GCM-SHA256", "clientHelloLength": 508,
           "clientCiphersSha1": "…", "clientExtensionsSha1": "…" },
  "http": { "protocol": "HTTP/2", "method": "GET", "priority": null, "acceptEncoding": "gzip, br" },
  "userAgent": { "raw": "curl/8.9.1", "browser": {…}, "engine": {…}, "os": {…},
                 "device": {…}, "cpu": {…}, "kind": "cli", "bot": { "name": "curl", "kind": "cli", "operator": null } },
  "headers": { "accept": "*/*", "host": "iseeu.cc", "user-agent": "curl/8.9.1" },
  "edgeHeaders": { "cf-ray": "…", "cf-ipcountry": "US", … },
  "time": { "server": "2026-10-08T12:00:00.000Z", "serverMs": 1791460800000 },
  "meta": { "docs": "https://iseeu.cc/api/", "privacy": "https://iseeu.cc/privacy/", "simulated": false }
}
```

値がないときは省略せずに`null`にするので、構造はいつも同じです。当てはまらない測定値や、測定されなかった値も同様です。`clientTcpRttMs`はTCP接続（HTTP/1.1とHTTP/2）のときだけ、`clientQuicRttMs`はHTTP/3のときだけ値が入ります。Cloudflareは測定していない値を0として報告しますが、こちらはそれを往復0ミリ秒として渡さず、`null`にして返します。地域とネットワークのデータは、接続元のアドレスに対するCloudflareのIPインテリジェンスに基づくもので、番地ではなく、あなたのプロバイダのネットワークを表します。`tls.clientCiphersSha1`と`clientExtensionsSha1`は、あなたのClientHelloをCloudflareがハッシュにしたもので、JA3やJA4ではありません。ChromeはTLS拡張の順序をランダムにするため、拡張のハッシュは接続のたびに変わるのがふつうで、2つのうちでは暗号スイートのハッシュのほうが安定しています。`userAgent.kind`は`browser`、`search-crawler`、`ai-crawler`、`ai-assistant`、`social-preview`、`http-library`、`cli`、`headless-browser`、`monitoring`、`bot`、`unknown`のいずれかです。

## よくある使い方

**ジョブを動かす前に、VPNやプロキシが有効かを確かめる。**出口の国を想定どおりの国と比べ、違っていれば処理を止めます。

```
country=$(curl -s "iseeu.cc/geo?format=text" | awk -F': ' '$1=="country"{print $2}')
[ "$country" = "DE" ] || { echo "VPN not in Germany (got $country)"; exit 1; }
```

**サーバーのグローバルアドレスを調べる。**コンテナやCIのランナー、クラウド関数の中では、ネットワークインターフェースにプライベートアドレスしか出てきません。`curl -s iseeu.cc`だけで十分で、末尾に改行が付くので、シェルのコマンド置換でも安心して使えます。

**HTTPクライアントが実際に何を送っているかを見る。**ライブラリはヘッダーを足したり、名前を変えたり、並べ替えたりします。コードから`/headers`を呼べば送られたヘッダーがそのまま見え、`/tls`を呼べば、ランタイムが実際に取り決めたTLSのバージョンと暗号スイートを確かめられます。

**ほかの言語から：**

```
// JavaScript (browser or Node 18+)
const me = await (await fetch("https://iseeu.cc/json")).json();

# Python
import requests; me = requests.get("https://iseeu.cc/json", timeout=5).json()

// Go
resp, _ := http.Get("https://iseeu.cc/ip")

# PowerShell
(Invoke-RestMethod https://iseeu.cc/json).location.country
```

## iseeu.ccの外に問い合わせるエンドポイント

`/api/rdap`と`/api/headers-check`は、それぞれ外部に1回リクエストを送るので、別枠のより低い上限があります。IPアドレスごとに1分あたり10回までで、それを超えると`429`と`Retry-After: 60`が返ります。RDAPの問い合わせ先は、IANAのブートストラップレジストリに載っているサーバーに限られます。ヘッダーチェックは、ポート80と443の公開`http`/`https` URLを受け付け、プライベートアドレス、予約済みアドレス、iseeu.cc自身（リダイレクト先として現れた場合も含む。このときは`400 invalid_target`）を拒否し、リダイレクトを5回までたどり、5秒で打ち切ります。どちらのエンドポイントも、問い合わせの内容を保存しません。

```
curl -s "iseeu.cc/api/rdap?q=AS64496" | jq .summary
curl -s "iseeu.cc/api/headers-check?url=https://example.com/" | jq '.grade | {grade, score}'
```

## 上限とフェアユース

- **IPアドレスごとに1分あたり60リクエスト。**超えると`429`と`Retry-After: 60`が返ります。上限はCloudflareの拠点ごとに数えるので、おおよその値です。
- MCPも含め、レスポンスは一切キャッシュされません（`Cache-Control: no-store`）。RESTのエンドポイントには`Access-Control-Allow-Origin: *`が付くので、どのサイトのブラウザJavaScriptからでも呼び出せます。
- 商用目的で使っていただいて差し支えありません。ただし、あなたのサイトの訪問者全員が読み込むページの裏で`/json`を呼ぶのは避けてください。その規模で使うなら、先にご連絡ください。
- 作ろうとしているものに1分あたり60リクエストでは本当に足りない場合は、[お問い合わせページ](https://iseeu.cc/ja/contact/)から詳しく教えてください。

## AIエージェント向けのMCPサーバー

`https://iseeu.cc/mcp`は、Streamable HTTPで動くリモートの[Model Context Protocol](https://modelcontextprotocol.io/)サーバーです。状態を持たず、認証も不要で、5つのツールを提供し、どれも読み取り専用です。`dns_lookup`と`rdap_lookup`は、外部への問い合わせに対する1分あたり10回の上限を共有します。

| ツール | 入力 | 内容 |
| --- | --- | --- |
| whoami | `include_headers?` | サーバーを呼び出しているマシンのグローバルIP、地域、ASNと組織名、Cloudflareのデータセンター、TLSとHTTPのバージョン、クライアントの種類 |
| check_headers | `headers?` | ボット判定で重視されがちな特徴を示します。User-AgentやAccept-Languageがない、クライアントヒントのないChrome、バージョンやプラットフォームの食い違い、別のIPを示すプロキシ系ヘッダー、DNTとGPCなどです。どのクライアントもヘッダーを省いたり偽ったりできるため、これは手がかりであって証拠ではありません。入力がなければ、呼び出し自体のヘッダーを調べます。 |
| parse_ua | `user_agent?` | ユーザーエージェントをブラウザ、エンジン、OS、デバイス、CPUに分解し、クローラー、AIエージェント、コマンドラインツール、ライブラリを見分けます |
| dns_lookup | `name`, `type?` | CloudflareのリゾルバーにDNS over HTTPSで問い合わせたA・AAAA・MX・TXT・NS・CNAME・CAA・SOAレコード。TTL、DNSSECフラグ付きで、存在しない名前（NXDOMAIN）とレコード型がないだけの場合を区別するヒントも返します |
| rdap_lookup | `query`, `include_raw?` | ドメイン、IPアドレス、AS番号の登録情報を、権威のあるRDAPサーバーから取得した要約 |

ブラウザで動くMCPクライアントは、どのオリジンからでも呼び出せます。CORSは`POST`、`GET`、`DELETE`を、`Content-Type`、`Mcp-Session-Id`、`Mcp-Protocol-Version`、`Last-Event-ID`のリクエストヘッダー付きで許可し、`Mcp-Session-Id`を公開します。MCPのレスポンスはすべて`Cache-Control: no-store`付きで送られ、サーバーは呼び出しと呼び出しの間に何も保持しません。リクエスト本文は64KBまで、JSON-RPCのバッチは10メッセージまでで、それより大きいものは、ツールを実行する前にエラー`-32600`で拒否します。

### 接続方法

```
# Claude Code
claude mcp add --transport http iseeu https://iseeu.cc/mcp

# Cursor, Windsurf, VS Code and other JSON configs
{ "mcpServers": { "iseeu": { "url": "https://iseeu.cc/mcp" } } }
```

`whoami`について、正直にお伝えしておきます。これが報告するのは、`/mcp`にHTTPリクエストを送ったマシンです。デスクトップやコマンドラインで動くエージェントならあなた自身のネットワークなので、プロキシやVPNが効いているかの確認に役立ちます。クラウドで動くアシスタントの場合は、提供元のサーバーになります。

## ディスカバリー用のファイル

- [/llms.txt](https://iseeu.cc/llms.txt)：言語モデル向けの短いプレーンテキストの案内
- [/.well-known/mcp/server-card.json](https://iseeu.cc/.well-known/mcp/server-card.json)：MCPサーバーカード
- [/openapi.json](https://iseeu.cc/openapi.json)：HTTPエンドポイントのOpenAPI 3.1による記述

## プライバシー

APIは、IPアドレス、ヘッダー、問い合わせの内容をログに残さず、データベースも持ちません。レスポンスはリクエストをもとにメモリ上で組み立て、そのまま捨てます。エンドポイントごとの呼び出し回数は数えますが、IPアドレスは含めません。何をどこまで扱うかは、[プライバシーポリシー](https://iseeu.cc/ja/privacy/)で項目ごとに説明しています。

APIは現状のまま提供しており、稼働率の保証はありません。地域やネットワークのデータが間違っていることもあります。セキュリティや不正対策の判断を、これだけに頼って下さないでください。

最終更新：2026-10-11

元のページ：https://iseeu.cc/ja/api/