appworth

appworth

这个应用值多少钱？appworth 是一个小型客户端，用于访问 App Dex 服务。该服务可估算任何应用在 iOS App Store 的收入和下载量——可按名称或数字形式的 App Store ID 查询——并为每个数值标注可信度，而不是把模型估算值当作实测结果呈现。

估算结果会附带置信度标签。用我们自己的话来说：verified 数值来自真实数据层的报告，而非模型估算；calibrated 数值由模型估算得出，但随后会根据同一收入类别应用的已验证面板数据进行调整；modeled 数值依据有限的公开信号得出，应仅作方向性参考——范围比其中的任何单一数值更重要。除非另有说明，数值均为总额（未扣除商店佣金），每晚重新计算，且仅涵盖 iOS App Store。查询按设计一次针对单个应用；不提供批量导出。

响应会原样返回服务提供的内容：整个过程中不会删减、重命名或概括。例如，上游返回的 Duolingo 响应如下：

  app:                Duolingo: Language Lessons
  category:           Education
  monthly_revenue:    $48.0M – $48.0M
  monthly_downloads:  5.0M – 5.0M
  confidence:         calibrated
  report_url:         https://app-dex.com/a/duolingo-language-lessons-570060128

配置

API 密钥为可选项。 原项目的配置表将 APPDEX_API_KEY 标为“必需”，但安装说明明确规定了实际行为，而此处以实际行为为准：没有密钥时，服务仍可正常工作——每天可请求 2 次，因此你可以先试用。免费密钥可将每日请求次数提升至 5 次。设置密钥后，每次请求都会通过 Authorization: Bearer <key> 发送该密钥；未设置时，请求不会携带 Authorization 标头，这绝不会导致错误。

Env var	Default	Notes
APPDEX_API_KEY	—	可选（见上文）。设置后将作为 Bearer 令牌发送。
APPDEX_API_URL	https://app-dex.com	仅用于覆盖为可自托管／暂存环境的地址。
APPDEX_TIMEOUT_MS	15000	请求超时时间（本服务）；超时属于获取失败。

对于旧版配置，仍会读取 APPINTEL_API_KEY / APPINTEL_API_URL 作为备用值：只有在相应的 APPDEX_* 变量未设置时，才会使用它们。

工具

• estimate_app — 查询单个 iOS 应用的月收入和下载量，并附带置信度标签。接受应用名称（app）或数字形式的 App Store ID。
• search_apps — 将名称（query）解析为 App Store ID，不返回任何数值——可用它查找要传给 estimate_app 的 ID。

上游返回非 2xx 响应时，会报错 appdex error: HTTP <status>；服务无法访问（包括超时）时，会报错 appdex unreachable。

端点来源

原项目的 README 明确列出了这两个工具、估算示例、配置变量和密钥可选的行为——但未说明请求路径或 Authorization 标头格式。以下内容为重建所得，并已标明：

• GET <base>/api/estimate?app=<urlencoded app>（由 estimate_app 使用）。
• GET <base>/api/search?q=<urlencoded query>（由 search_apps 使用）。
• 设置密钥时使用 Authorization: Bearer <key> 标头格式。

CLI

每个工具都是一个子命令，接受一个 JSON 参数字符串：

npx @reneturcios/appworth estimate_app '{"app":"Duolingo"}'
npx @reneturcios/appworth estimate_app '{"app":"570060128"}'
npx @reneturcios/appworth search_apps '{"query":"Duolingo"}'
npx @reneturcios/appworth --version

输出为工具的结果文本（成功时即上游响应正文）。退出码：成功时为 0，运行时错误时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/appworth mcp

MCP 客户端配置（密钥为可选项；如果有密钥，请通过客户端的环境变量提供）：

{
  "mcpServers": {
    "appworth": {
      "command": "npx",
      "args": ["-y", "@reneturcios/appworth", "mcp"],
      "env": {
        "APPDEX_API_KEY": "<your key>"
      }
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/appworth
docker run --rm ghcr.io/cloudcorprecords/appworth search_apps '{"query":"Duolingo"}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

许可证

MIT — 版权所有 (c) 2026 Rene Turcios