本文へ移動

OpenNavoで開発する

MCP または HTTP で、OpenNavo の公開された読み取り専用 Mac アプリカタログにツールを接続できます。

匿名で利用できる公開 MCP サーバーまたは読み取り専用 HTTP API を使って、カタログを検索し、アプリを確認し、リリースと依存関係を参照し、公開コレクションと記事を読むことができます。

公開 MCP

読み取り専用カタログツールを 9 個備えた、ストリーミング対応 HTTP MCP サーバーです。アカウントやトークンは必要ありません。

MCP エンドポイント https://opennavo.com/mcp

MCP クライアントを接続

Claude Desktop

{
  "mcpServers": {
    "opennavo": {
      "url": "https://opennavo.com/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http opennavo https://opennavo.com/mcp

Cursor

{
  "mcpServers": {
    "opennavo": {
      "url": "https://opennavo.com/mcp"
    }
  }
}

Codex

[mcp_servers.opennavo]
url = "https://opennavo.com/mcp"

公開 HTTP API

公開 API は、ベースパス /api/v1 の下で安定した匿名 GET エンドポイントを提供します。パラメーターとレスポンススキーマの正本は OpenAPI ドキュメントです。

curl で検索

curl --get 'https://api.opennavo.com/api/v1/search' \
  --data-urlencode 'q=Visual Studio Code' \
  --data-urlencode 'size=5'

レート制限

制限は Redis をバックエンドとする GCRA リミッターでクライアント IP ごとに適用されます。レスポンスヘッダーで残りの容量を確認できます。

  • 通常の読み取りエンドポイント:IP ごとに 60 秒あたり 300 リクエスト。
  • 検索:IP ごとに 60 秒あたり 60 リクエスト。
  • 公開 MCP:レート制限は IP ごとに 60 秒あたり 60 リクエストです。
  • HTTP 429 レスポンスには秒単位の Retry-After が含まれます。成功した API レスポンスには X-RateLimit-Limit と X-RateLimit-Remaining が含まれます。

利用規約

これらのインターフェースは、公開されている OpenNavo カタログデータへの有用で責任あるアクセスを提供します。

  • 公正利用:リクエスト量を適切に保ち、可能な場合は結果をキャッシュしてください。
  • 帰属表示:カタログデータや派生物を公開する場合は、opennavo.com の関連ページにリンクしてください。
  • SLA なし:サービスレベルの保証なく、インターフェースが変更、制限、または利用できなくなる場合があります。
  • スクレイピング:公開された制限を超えてスクレイピングしたり、IP 単位の制御を回避したりしないでください。
  • 読み取り専用:公開 API と MCP は、アカウント、書き込み、管理操作を提供しません。