# collect_feedback

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

URL: https://mcp-docs.opennomos.com/zh/docs/tools/research/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 评论。

> 以上是服务端发布的英文描述的译文；英文原文见[英文页](https://mcp-docs.opennomos.com/docs/tools/research/collect_feedback.md)。工具名、参数名和取值保持原样。

| 字段 | 值 |
| --- | --- |
| 工具包 | 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 不生效。 |

## 示例调用

```json
{
  "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`。

## 示例结果

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

```json
{
  "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`，这会按来源分别出现。见[错误](https://mcp-docs.opennomos.com/zh/docs/reference/errors.md)。

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