工具调研
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 | 是 | string | google_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。