跳到正文

用 OpenNavo 构建工具

通过 MCP 或 HTTP 连接 OpenNavo 的公开只读 Mac 应用目录。

你可以使用无需登录的公共 MCP,或只读 HTTP API,搜索目录、查看应用、浏览版本和依赖,并读取公开的合集与文章。

公共 MCP

基于可流式 HTTP 的 MCP 服务,提供 9 个只读目录工具,无需账号或令牌。

连接 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'

速率限制

限制按客户端 IP 使用 Redis GCRA 实现。响应头会告诉你剩余容量。

  • 普通只读端点:每个 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 不提供账号、写入或管理操作。