OpenNomos文档
工具调研

collect_feedback

读取评价或评论,返回原始数据。

读取评价或评论,返回原始数据。source=google_play:id 是包名(约 5 秒,$0.00015)。source=app_store:id 是数字应用 id,country 默认 us(约 16 秒,$0.00015)。source=youtube_comments:id 是视频 id(约 6 秒,$0.001)。> 返回文本、评分(如有)、作者和日期。可选的 sort 适用于 App Store 或 YouTube 原生的排序参数;language_code 适用于 YouTube 评论。

以上是服务端发布的英文描述的译文;英文原文见英文页。工具名、参数名和取值保持原样。

字段值
工具包Feedback (feedback)
每次调用的预估成本~$0.001(上游成本;各 action 的具体数字见描述)
工具包每月上限上游成本 $1(不向用户显示)
项目可选(project 或 X-OpenNomos-Project);只是把项目 id 附在结果里

参数

参数必填类型说明
project否string项目 slug 或 id。省略则用凭据或工作区的默认项目。
source是"google_play" | "app_store" | "youtube_comments"从哪里读取。
id是stringgoogle_play:包名,例如 'com.spotify.music'。app_store:数字应用 id,例如 '324684580'。youtube_comments:视频 id,例如 'dQw4w9WgXcQ'。
country否string仅 app_store:两位商店国家代码,例如 'us'、'cn'、'jp'。默认 'us'。
sort否string仅 app_store 或 youtube_comments:来源自己的排序值,原样透传。省略则用来源的默认顺序。
language_code否string仅 youtube_comments:语言代码,例如 'en'。
limit否integer (≥ 1, ≤ 100)仅 google_play:最多返回多少条评价。默认 20。对 app_store 和 youtube_comments 不生效。

示例调用

{
  "source": "app_store",
  "id": "310633997",
  "country": "us",
  "limit": 20
}

REST:POST https://service.opennomos.com/v1/tools/collect_feedback,以上 JSON 作为请求体。MCP:tools/call,name: "collect_feedback",以上 JSON 作为 arguments。

示例结果

示例里的值是示意性的;结构来自服务端代码。

{
  "results": [
    {
      "text": "…",
      "rating": 4,
      "author": "…",
      "date": "2026-10-01"
    },
    "…"
  ]
}

说明

  • id 的含义:google_play 是包名,app_store 是数字应用 id,youtube_comments 是视频 id。
  • 返回评价或评论的原文,有评分时带评分,另有作者和日期。具体字段名来自服务商。

错误

上游出问题时,会在一个正常结果里以 error、reason 和 action 报告(适用时还有 tool / retry_after_seconds)。对 search_signals,这会按来源分别出现。见错误。

这个工具属于 Feedback 工具包。如果该包没有启用,调用会以 pack_required(HTTP 403)失败;如果该包的每月上游成本上限已用完,会以 soft_limit(HTTP 429)失败。两者都带 action: "give_up_and_tell_user" 和控制台 URL。

本页目录