# 分页 (https://sellersheetai.com/zh/docs/mcp-api/paging)

> 列表类工具返回一页结果和下一页的令牌。再次调用是 AI 的一步——或你代码循环里的一步。



亚马逊的长列表是一页一页返回的，封装这些列表的 SellerSheet 工具也一样。返回结果从不告诉 AI “再调用一次”——工具描述里写明了如何翻页，由 AI 决定是否需要下一页。

## 怎么用 [#怎么用]

1. 不带令牌调用工具——得到第一页；如果还有更多，`data` 里会带一个令牌（用亚马逊自己的名称，例如 `nextToken`）。
2. 用同样的参数加上这个令牌再调用一次——得到下一页。
3. 结果里没有令牌，说明已经是最后一页。

接收令牌的参数名写在每个工具的参考页里——通常是 `pagination_token` 或 `next_token`，有时沿用厂商自己的拼写。大多数列表工具还接受每页数量，例如 `page_size`。

<ToolCall tool="orders_searchOrders" args="{ created_after: &#x22;2026-10-01T00:00:00Z&#x22;, pagination_token: &#x22;<data.nextToken from the previous call>&#x22; }" lang="zh" />

## 好习惯 [#好习惯]

* **“没有令牌”传 `null`，不要传空字符串。** 每个可选参数都接受显式的 `null`，所以 AI 可以从 `pagination_token: null` 开始。
* **翻页时其他参数保持不变**；令牌属于它所在的查询。
* **历史数据查仓库。** “上季度的所有订单”是对同步数据表的一次 `query_report_data` 调用（配合 `limit` 和 `offset`），而不是向亚马逊翻几百页——而且完全不消耗亚马逊的频率限额。见[同步报表](/zh/docs/mcp-api/workflows/reports)。
* **边取边写。** 要把整个目录写进表格时，AI 每取一页就先追加到表格，再取下一页，长流程不必把所有数据都留在手里。