淘宝/天猫商品详情数据接入:标题、价格、销量、主图一次拿
给 AI Agent 一个淘宝/天猫商品 ID 或链接,自动拿回结构化详情和描述图:标题、价格、销量、主图、SKU 一次到手,不用解析页面、不用维护爬虫。

本文中的工具名仅供参考,实际工具可能已更新或更名。实施时请以工具市场中的最新工具为准。
本文要点
- 给 Agent 一个商品 ID 或链接,就能拿回结构化的淘系商品详情
- 支持按 ID 和按链接两种入口,还能单独取商品描述图
- 用现成接口取数,不用自己解析页面或维护反爬爬虫
本文用到的工具
为什么拿淘系商品详情这么折腾
要把一个淘宝或天猫商品的标题、价格、销量、主图、SKU 规整地拿到手,看着简单,真做起来全是坑。页面结构经常改,字段藏在动态渲染里,描述图又是一串懒加载的地址;自己写爬虫,还要处理登录态、翻页、验证码和反爬,维护成本高到每隔几周就得返工一次。
如果只是偶尔看一两个商品,手动复制还能忍;可一旦要批量入库、做选品对比、喂给下游分析,手工路线立刻崩溃。传统方案是自己对接淘系数据接口,门槛不低,而且接口一变就得跟着改。
AgentEarth 的思路是把这些能力做成一组现成工具:你给 Agent 一个商品 ID 或一条链接,用一句自然语言描述要什么,Agent 自己挑工具、取数、整理成结构化记录。
这个工作流分四步
- 给入口:把商品 ID 或商品链接交给 Agent。
- 取结构化详情:按 ID 或按链接拿回标题、价格、销量、主图、SKU。
- 取描述图:单独拉商品描述里的长图。
- 整理入库:Agent 汇成结构化记录,入库或接下游分析。
每一步怎么做
第一步:把 ID 或链接给 Agent
直接说你手上有什么。比如:用 ae 取这个淘宝商品的详情,ID 是 1234567890,或者 用 ae 解析 https://example.com/item">https://example.com/item 这条链接的商品详情"。你不用知道背后调哪个接口。
第二步:按 ID 或按链接取结构化详情
- 手上是商品 ID 时,用淘系详情查询类工具(如
ae_tmapi_taobao_item_detail)按 ID 取回结构化详情。 - 手上只有一条分享链接时,用按链接取详情类工具(如
ae_tmapi_taobao_item_detail_by_url)直接解析链接——省去从链接里抠 ID 的步骤。
两个入口返回的是同一套结构化字段:标题、价格、销量、主图、SKU 变体等,Agent 拿到的是干净的数据,不是一坨 HTML。
第三步:取商品描述图
商品详情页正文里那串长描述图,用描述图查询类工具(如 ae_tmapi_taobao_item_desc_images)单独拉回地址列表,适合做素材归档或图片内容分析。
第四步:整理成结构化记录
让 Agent 把详情字段和描述图合成一条记录——比如写进表格或数据库。要批量时,给一组 ID 或链接循环跑这条链即可。
| 做法 | 稳定性 | 维护成本 | 字段完整度 |
|---|---|---|---|
| 自己解析页面 / 写爬虫 | 页面一改就挂 | 高,隔几周返工 | 要自己抠,易漏字段 |
| 用结构化接口取数 | 接口稳定、不碰页面 | 低,一句话调用 | 标题/价格/销量/主图/SKU 齐全 |
怎么开始
- 注册 AgentEarth —— 新用户赠送 1000 积分。
- 在 WorkBuddy、Trae 这类 Agent 里搜索 "AgentEarth" 端内连接;或把一行 MCP 配置粘进 Claude Code / Cursor / VSCode。
- 直接用自然语言下指令,比如 用 ae 取这个淘宝商品的详情并整理成记录。
常见问题
支持 ID 和链接两种入口吗? 都支持。手上是商品 ID 用按 ID 取详情类工具(如 ae_tmapi_taobao_item_detail),只有分享链接就用按链接取详情类工具(如 ae_tmapi_taobao_item_detail_by_url),不用自己从链接抠 ID。
能单独拿描述图吗? 能。用描述图查询类工具(如 ae_tmapi_taobao_item_desc_images)单独拉描述里的长图地址列表,做素材归档或图片分析都行。
返回哪些字段? 结构化详情通常包含标题、价格、销量、主图、SKU 变体等常用字段。你只需要一把 AgentEarth 的 Key,用自然语言下指令,不用自己维护淘系登录态或对接接口。
