# TikTok Shop scraper API 接 Gemini 找 1688 货源

> TikTok Shop 热卖榜测试时一直 503，我们改拿带货视频封面去 1688 以图搜：6 个商品 4 个找到同款，小飞仙零售价是进价的 4 倍。

- Canonical page: https://everyinfra.com/blog/tiktok-shop-scraper-api
- Published: 2026-11-18T02:06:00+08:00 · Fact-checked: 2026-11-18T01:53:00+08:00

2026 年 11 月 18 日 00:14 到 01:33（新加坡时间），我们照「TikTok Shop 东南亚热卖榜 → 1688 以图搜同款 → 算价差」这条链真调 EveryInfra：TikTok Shop 热卖榜、类目、店内搜索三项能力连同一次 MCP 调用共 70 次，全部返回 503、没有扣费，于是改从 TikTok 视频搜索取马来西亚和菲律宾的带货视频，挑 6 个商品的封面去 1688 以图搜。30 个候选里 13 个是同款，6 个商品里 4 个找到了同款；感应小飞仙玩具和足底按摩拖鞋在马来西亚 Shopee、Lazada 上的同类零售价中位数，是 1688 同款进价的 4.0 倍和 3.6 倍，菲律宾的灰色阔腿卫裤只有 1.7 倍。一款能拍照的手持风扇，以图搜只认出了风扇，换成关键词「相机风扇」才搜到带摄像头的二合一，进价差了 5 倍多。

> **本文要点**
>
> - 找货链四步：TikTok Shop 热卖榜（`tiktok/shop_hot_products`，每次 0.000806 美元）→ 1688 以图搜（0.005556 美元）→ 1688 和淘宝关键词搜 → 换算汇率算价差倍数。Gemini 4 Hydrogen 用远程 MCP 调接口、看图判同款、按 JSON Schema 填表。
> - 测试期间热卖榜一直返回 503 且不扣费；改用 `tiktok/search` 取带货视频封面，6 个商品以图搜共 30 个候选，13 个同款（43%），低于用商品主图时的 60%。
> - 价差倍数（当地 Shopee、Lazada 同类零售价中位数 ÷ 1688 同款进价）：感应小飞仙 4.0、按摩拖鞋 3.6、阔腿卫裤 1.7；光环桌面风扇两边都没对齐，倍数 0.85 不能用。
> - 以图搜看不到功能：能拍照的风扇被搜成普通风扇（中位数 17 元，约 2.55 美元），带功能词的关键词搜中位数 98 元（约 14.70 美元）。
> - 每 100 个商品：EveryInfra 数据费约 0.84 美元，Gemini 用 300 像素缩略图加批处理约 0.42 美元；本文全部真调花了 0.0574 美元。

## 这条找货链分四步

Gemini 负责链上要判断的地方：哪张候选图是同款、中文关键词怎么写、表怎么填。本文 Gemini 一侧的代码是配置示例，我们没有在 Gemini 上实际运行；数据一侧的每个数都来自上面那段时间里的真实调用，同款判定由作者一人按事先写好的规则看图完成。

![示意图：左边一部手机屏幕上是一列商品，箭头指向中间两张并排的商品图在做比对，再指向一个闪光标记，最右边是一张填好的表格。](https://everyinfra.com/articles/tiktok-shop-scraper-api/img-sourcing-flow.webp)

找货链四步：热卖榜、以图搜、关键词搜、算价差；中间的比对和填表交给模型。 [EveryInfra 自绘](https://everyinfra.com)

| 步骤 | 能力 | 每次费用（美元） | 拿到什么 |
| --- | --- | --- | --- |
| 1 取热卖榜 | `tiktok/shop_hot_products` | 0.000806 | 20 条商品：售价、累计销量、主图地址 |
| 2 以图搜同款 | `alibaba1688/image_search` | 0.005556 | 5 个 1688 候选：标价、起订量、商家名 |
| 3 关键词搜同类 | `alibaba1688/search`、`taobao/search` | 0.002778、0.0135 | 同类商品的批发价和零售价分布 |
| 4 算价差 | 不调接口 | 0 | 每个商品的价差倍数 |

这几项能力在 [TikTok 数据接口](/tiktok-api)、[1688 数据接口](/alibaba1688-api) 和 [淘宝数据接口](/taobao-api) 三个页面上都有参数说明和在线试调；单项能力页是 [TikTok Shop 热卖榜](/tiktok-api/shop_hot_products)、[TikTok Shop 类目商品](/tiktok-api/shop_category_products)、[1688 以图搜](/alibaba1688-api/image_search)、[1688 关键词搜](/alibaba1688-api/search) 和 [淘宝搜索](/taobao-api/search)。

## tiktok shop scraper api：热卖榜接口和这次的 503

`tiktok/shop_hot_products` 取的是 TikTok Shop 某个站点的热卖榜，参数只有两个：`country` 和 `limit`。目录列出的站点是印尼、日本、墨西哥、马来西亚、菲律宾、新加坡、泰国、越南 8 个，默认马来西亚；`limit` 最多 100，我们用 20，每次 0.000806 美元（[EveryInfra 目录：TikTok](https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok)）。另一个入口 `tiktok/shop_category_products` 按类目 ID 取商品，一页约 15 条，用 `page_token` 翻页，美国站也能取，适合盯住一个类目连续看。我们挑了马来西亚、菲律宾、泰国、越南四个站：这四个站都能从中国直发或走海外仓，印尼有单件 100 美元的 FOB 门槛（后面费用和税一节会讲），不放进来。

目录的 `response_fields` 列出每一行商品带 `rank`、`id`、`url`、`name`、`price`、`original_price`、`currency`、`sold_count`、`rating`、`review_count`、`shop_name`、`shop_id` 和 `image_url`。找货源要用的是三样：`price` 和 `currency` 算售价，`sold_count` 看卖了多少，`image_url` 拿去以图搜。价格是当地货币，林吉特、比索、泰铢、越南盾各不相同，要换成同一种货币才能比。

### 这一次：热卖榜一直取不到

2026 年 11 月 18 日 00:14（新加坡时间）我们开始取榜，先是马来西亚、菲律宾、泰国、越南四个站各 20 条，为了确认是不是个别站点的问题，又试了新加坡和印尼，又试了 `tiktok/shop_category_products`（马来西亚和美国站的美妆类目）和 `tiktok/shop_search`。到 01:33 最后一次为止，这几项连同一次 MCP 调用一共 70 次，每次都返回 HTTP 503，错误码 `unavailable`，`billing.charged` 为 `false`，一分钱没扣。错误对象写明可以重试：`retryable` 为 `true`、`retry_after` 为 60 秒、`max_retries` 为 2；从 00:49 起我们按 30 秒一次轮流重试四个站，01:08 停下，01:33 又补调了一次马来西亚站，结果没有变化。前 16 次只留了汇总记录，其余 54 次逐条留有 request_id。走 MCP 的 `everyinfra_call_api` 也是同样的返回。

![散点时间线：横轴是 2026 年 11 月 18 日 00:14 到 01:06 的新加坡时间，下面一行灰点是 TikTok Shop 热卖榜、类目和 MCP 调用，从 00:24 到 01:08 密集排开，全部返回 503；上面一行青绿点是 1688、淘宝、Google 购物和 TikTok 视频搜索的调用，集中在 00:53 到 01:04，全部返回 200。](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-calls-timeline.zh.light.svg)

对选品流程，这有两个直接含义。第一，热卖榜这类接口可能一段时间取不到，日常任务要允许「这一天这个站没取到」，其余步骤照常跑；失败不扣费，所以按 `retry_after` 重试本身不花钱，花的是时间。第二，热卖榜不是 TikTok 一侧唯一的入口。同一时间 `tiktok/search`（视频关键词搜索）一直正常，带货视频的封面通常就是商品特写，可以直接拿去以图搜。所以 TikTok 一侧改用视频搜索：在马来西亚和菲律宾各搜一次「tiktok shop」相关的视频，从封面里挑商品。

### 退一步：从带货视频里挑商品

00:53 我们用关键词「tiktok shop malaysia」取了 20 条视频，01:01 用「tiktok shop philippines」又取了 20 条，每次 0.000556 美元（[TikTok 视频搜索](/tiktok-api/search)）。返回里每条视频都有 `view_count`、`posted_at`、`is_ad`、`hashtags` 和 `cover_image_url`。

| 站点 | 取数时刻（新加坡时间） | 视频数 | `is_ad` 为 true | 播放中位数 | 近 60 天发布 | 封面是商品特写 |
| --- | --- | --- | --- | --- | --- | --- |
| 马来西亚 | 00:53 | 20 | 16 | 182,750 | 10 | 7 |
| 菲律宾 | 01:01 | 20 | 13 | 86,000 | 13 | 3 |

![分组柱状图：马来西亚和菲律宾各 20 条 tiktok shop 视频。is_ad 为 true 的马来西亚 16 条、菲律宾 13 条；近 60 天发布的马来西亚 10 条、菲律宾 13 条；封面是商品特写的马来西亚 7 条、菲律宾 3 条。](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-videos-bar.zh.light.svg)

马来西亚的 20 条里，有 7 条封面就是商品本身：一套粉色锅具、一口粉色多功能小锅、一个相机造型的手持风扇、一个会飞的小仙女玩具、一双足底按摩拖鞋、一个车内摆件、一台带光环的桌面风扇。菲律宾的 20 条大多是真人出镜、直播预告和品牌大促，封面是商品特写的只有 3 条：一件印花 T 恤、一包软糖、一条灰色阔腿卫裤。这和菲律宾 11.11 期间「购物者转向内容创作者」的报道对得上（[The Manila Times](https://www.manilatimes.net/2026/11/10/news/filipino-shoppers-pivot-to-content-creators-for-1111/2466071)）：人出镜越多，封面越难拿去以图搜。

我们从中挑了 6 个不带明显品牌的商品：马来西亚 4 个（相机造型风扇，99.98 万次播放；感应小飞仙，210 万次；按摩拖鞋，35.82 万次；光环桌面风扇，320 万次），菲律宾 2 个（印花 T 恤，40.41 万次；阔腿卫裤，7.12 万次）。食品、锅具套装和车内宗教摆件没有选：食品进口要单独办手续，锅具套装是多件组合，以图搜只能对上其中一件。

## tiktok shop product scraper 的替代：拿视频封面去 1688 以图搜

判定规则在 00:46 写定，早于 00:54 第一次以图搜，三档：「同款」要求外形、结构、配件和主要配色都对得上，只是拍摄角度、背景或文字贴纸不同；「近似」是同一类商品、功能相同，但外形或结构有可见差别，比如支架的夹臂换了样式；「不同」是品类都对不上。只有「同款」进入价差计算，「近似」只记录，不算进倍数。这套规则也是给 Gemini 结构化输出里 `match` 字段的三个枚举值，人判和模型判用同一把尺子。判定只有作者一人，没有第二位判定人对照。

00:54 到 01:03 之间，我们把 6 张视频封面的 `cover_image_url` 依次传给 `alibaba1688/image_search`，每次回 5 个候选，每次扣 0.005556 美元，6 次共 0.0333 美元。候选行里有 `price`、`currency`、`min_order_quantity`、`order_count`、`supplier_name` 和候选主图 `image_url`。我们把每张封面和它的 5 张候选图拼在一起看，按上面的规则逐个打标。

![堆叠横条图：6 个商品各 5 个 1688 候选的判定。相机造型风扇 5 个近似；感应小飞仙 4 个同款 1 个不同；足底按摩拖鞋 4 个同款 1 个近似；光环桌面风扇 1 个同款 4 个近似；印花 T 恤 3 个近似 2 个不同；灰色阔腿卫裤 4 个同款 1 个近似。合计 30 个候选里 13 个同款。](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-match-bar.zh.light.svg)

| 商品（站点） | 播放 | 同款 / 近似 / 不同 | 同款的 1688 标价（元） | 同款商家所在地 |
| --- | --- | --- | --- | --- |
| 相机造型风扇（马来西亚） | 999,800 | 0 / 5 / 0 | — | — |
| 感应小飞仙玩具（马来西亚） | 2,100,000 | 4 / 0 / 1 | 5.9、7.9、8、16.5 | 汕头澄海、义乌、芜湖 |
| 足底按摩拖鞋（马来西亚） | 358,200 | 4 / 1 / 0 | 11.8、11.8、12、15 | 揭阳、义乌 |
| 光环桌面风扇（马来西亚） | 3,200,000 | 1 / 4 / 0 | 88.8 | 深圳 |
| 印花 T 恤（菲律宾） | 404,100 | 0 / 3 / 2 | — | — |
| 灰色阔腿卫裤（菲律宾） | 71,200 | 4 / 1 / 0 | 18、18、18、22 | 广州、揭阳 |

30 个候选里 13 个同款，占 43%；6 个商品里 4 个至少找到一个同款。我们之前那篇 1688 找货的文章用的是电商商品主图，25 个候选里 15 个同款，占 60%（[Claude Code 从 1688 找货到 Yandex Market 算毛利](/blog/claude-code-1688-sourcing-yandex-market-margin)）。视频封面的命中率低一截，原因从图上就能看出来：封面里有人、有大字标题、有好几件商品挤在一起，以图搜只能抓住画面里最显眼的那个形状。

感应小飞仙的 4 个同款，标价从 5.9 元到 16.5 元，差了将近 3 倍；成交最多的是义乌一家商行，标价 5.9 元、成交 5,691 笔，起订 1 件。按摩拖鞋的 5 个候选里有 4 个同款，第 2 个是同一个鞋底换成白色，按规则只算近似。阔腿卫裤的 4 个同款用的是同一张商品图，挂在 3 个不同的店铺名下，4 条加起来只成交了 1 笔，起订量都是 1 件；这种「同图多店、几乎没有成交」的情况，说明你看到的可能是同一批货的多个转卖页面，下单前要用 `alibaba1688/product_detail` 看清阶梯价和发货地，最好先拿样。

![点图：6 个商品各 5 个 1688 候选的标价，横轴为对数轴从 0.5 到 200 元。感应小飞仙的 4 个同款在 5.9 到 16.5 元；按摩拖鞋的同款在 11.8 到 15 元；阔腿卫裤的同款在 18 到 22 元；光环桌面风扇唯一的同款 88.8 元；相机造型风扇的 5 个近似在 5 到 38 元；印花 T 恤的候选从 0.6 元到 35 元。](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-spread-scatter.zh.light.svg)

两个没找到同款的商品各有原因。印花 T 恤的印花在候选里出现了 3 次，但分别印在白色短袖、白色卫衣和深色长袖上，没有一件是米色短袖；另外 2 个候选一个是装衣服的塑料袋（0.6 元，图里装的是这件 T 恤），一个是篮球队夹克。

## 关键词搜 1688 和淘宝：给进价一个参照

以图搜一次只回 5 个候选，命中「同款」就有一个具体的进价；没命中时，还需要知道这类商品在 1688 上一般卖多少。`alibaba1688/search` 按中文关键词搜，一次最多 100 条、默认 20 条，`sort` 可选 `relevance`、`popular`、`price_asc`、`price_desc`，返回里有 `price_min`、`min_order_quantity`、`order_count`、`supplier_name` 和发货城市（[EveryInfra 目录：1688](https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688)）。我们用 `popular` 排序取 20 条，算价格中位数，作为「这一类货在批发市场的常见价位」。淘宝的 `taobao/search` 回的是零售价，一次最多 20 条，用来看同类商品在中国零售端卖多少；它比 1688 贵（每次 0.0135 美元），所以只给少数商品调。

关键词是人根据 TikTok 商品名翻成中文写的，不是机器直译。东南亚站的商品名常常把功能、型号、促销字样堆在一起，直译成中文去搜，回来的多半是无关商品。写关键词时只保留「品类 + 一两个关键特征」，比如「磁吸手机支架」，不带品牌、不带促销字样。这一步交给 Gemini 也行，但要在指令里写明这条规则。

### 相机造型风扇：以图搜只认出了风扇

马来西亚那条 99.98 万次播放的视频，文案写的是「2-in-1 Camera Fan」，封面上几台机器都带一块屏幕。它是一台能拍照录像的手持风扇。以图搜回的 5 个候选全是普通手持风扇，有挂脖的、带数显的、带喷雾的，外形都对不上，功能也少了拍照这一项，按规则 5 个都是近似，标价中位数 17 元。

00:58 我们用关键词「相机风扇」在 1688 按 `popular` 搜了 20 条，0.002778 美元。20 条里 19 条标题带「相机」「摄像」「云台」或「记录仪」，其中 6 条明说是风扇和相机二合一，标价 18 元到 115 元；19 条的标价中位数是 98 元，是以图搜那 5 个风扇的 5 倍多。也就是说，这类商品的进价在 90 元上下，而以图搜给的 17 元是另一类东西的价。同一个词拿到 Google 购物马来西亚站搜「camera fan」，回来的又大多是给相机散热的配件，只有两条标题写着手持风扇或二合一，售价 131.68 林吉特和 174.46 林吉特。

![点图：同一个相机造型手持风扇，下面一行是以图搜回的 5 个候选标价，集中在 5 到 38 元；上面一行是关键词相机风扇搜回的 20 条标价，大多在 65 到 128 元之间。](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-kw-scatter.zh.light.svg)

规则：以图搜只看得到形状，看不到功能。封面上的商品如果有拍照、加湿、蓝牙这类从外观看不出的功能，要从视频文案里把功能词读出来，和品类词一起拼成关键词再搜一次；两次结果对不上时，以带功能词的关键词搜为准。Gemini 可以同时读封面和文案，这一步交给它比交给纯图像检索合适。

关键词搜的另一个用处，是给整个品类画价位。后文那张调用截图里的「磁吸手机支架」，按 `popular` 排序的 20 条标价从 2.6 元到 47 元，中位数 18.9 元；成交过千笔的 9 条里，最便宜的 2.6 元、最贵的 47 元。同一个关键词下价格差 18 倍，说明「1688 进价」不是一个数，要先对上同款，再看同款里的阶梯价。

![散点图：1688 关键词磁吸手机支架按 popular 排序的 20 条结果，横轴标价从 2.6 元到 47 元，纵轴成交笔数用对数轴从 1 到 8 万；成交过千笔的 9 条标为青绿色，分布在 2.6 元到 47 元之间。](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-1688-scatter.zh.light.svg)

淘宝这边我们只调了一次，搜「感应飞行小飞仙」，0.0135 美元，回了 10 条：零售标价从 8.8 元到 32.8 元，中位数 16.9 元，是 1688 同款进价中位数 7.95 元的 2.1 倍。淘宝回的是国内零售价，它告诉你同一件货在国内卖多少：如果东南亚的售价还不到国内零售价的两倍，扣掉跨境运费和平台费之后，空间就很小了。

| 感应小飞仙的三档价格 | 能力 | 价格 | 折合美元 | 是 1688 进价的几倍 |
| --- | --- | --- | --- | --- |
| 1688 同款（4 条中位数） | `alibaba1688/image_search` | 7.95 元 | 1.19 | 1.0 |
| 淘宝零售（10 条中位数） | `taobao/search` | 16.9 元 | 2.54 | 2.1 |
| 马来西亚线上零售（11 条中位数） | `google_shopping/search` | 19.51 林吉特 | 4.77 | 4.0 |

## 价差倍数：当地零售参照价是进价的几倍

价差倍数 = 马来西亚或菲律宾的线上零售参照价（Google 购物里 Shopee、Lazada 同类商品报价的中位数）换成美元 ÷ 1688 同款进价换成美元。汇率统一用欧洲央行 2026 年 11 月 17 日的参考价：1 美元兑 6.6661 元人民币、4.0935 林吉特、63.676 菲律宾比索、33.84 泰铢（[欧洲央行参考汇率](https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html)，经 [Frankfurter](https://github.com/hakanensari/frankfurter) 取数）；欧洲央行不发越南盾，越南盾按 open.er-api 同日的 25,747 计。1688 的价用以图搜或关键词搜返回的标价，不是你下单数量对应的阶梯价，也不含国内运费。

热卖榜取不到，TikTok Shop 上的成交价也就拿不到。我们改用 `google_shopping/search` 取当地的线上零售价做参照，国家设成 `my` 或 `ph`，每次 0.000556 美元（[Google 购物数据接口](/google-shopping-api)）。取数前先写定了筛选规则：只留商家为 Shopee 或 Lazada 的条目，标题里要有品类词（如 fairy、slipper、fan、sweatpants），取价格中位数。这样做排除了玩具反斗城、阿迪达斯、Uniqlo 这类品牌店和 eBay 上的收藏品，留下的大多是和 TikTok Shop 同一批跨境卖家在别的平台上的报价。它不等于 TikTok Shop 的成交价，也不是逐条核过的同款价，只是同一个市场里同类商品的价位：小飞仙那 11 条只按标题里有 fairy 筛，价格从 8.81 到 48 林吉特。

| 商品（站点） | 1688 同款进价中位数 | 当地同类零售参照中位数（条数） | 换成美元 | 价差倍数 |
| --- | --- | --- | --- | --- |
| 感应小飞仙玩具（马来西亚） | 7.95 元（1.19 美元） | 19.51 林吉特（11 条） | 4.77 美元 | 4.0 |
| 足底按摩拖鞋（马来西亚） | 11.9 元（1.79 美元） | 26.62 林吉特（11 条） | 6.50 美元 | 3.6 |
| 光环桌面风扇（马来西亚） | 88.8 元（13.32 美元） | 46.5 林吉特（9 条） | 11.36 美元 | 0.85 |
| 灰色阔腿卫裤（菲律宾） | 18 元（2.70 美元） | 299 比索（5 条） | 4.70 美元 | 1.7 |

![分组柱状图：4 个找到同款的商品，灰柱是 1688 同款进价、青绿柱是当地零售参照价，都换成美元。感应小飞仙 1.19 对 4.77 美元，4.00 倍；按摩拖鞋 1.79 对 6.50 美元，3.64 倍；光环桌面风扇 13.32 对 11.36 美元，0.85 倍；灰色阔腿卫裤 2.70 对 4.70 美元，1.74 倍。](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-markup-bar.zh.light.svg)

小飞仙和按摩拖鞋的倍数在 3.6 到 4.0 之间，阔腿卫裤只有 1.7。服装在东南亚的零售价本来就低，菲律宾 Lazada 上同类卫裤 169 到 369 比索，进价 18 元的卫裤卖 299 比索，扣掉下一节列出的 8.2% 到 9.2% 的平台费率和类目佣金，再加国际运费，所剩无几。

光环桌面风扇的 0.85 倍要分开看。1688 那一条同款标价 88.8 元，挂在一家「电子市场展柜」名下、只成交 7 笔，这个进价本身不可靠；马来西亚的 9 条零售参照里有 15.58 林吉特的小台扇，也有 179 林吉特的品牌台扇，没有一条是这款带光环的设计。两边都没对齐时，倍数没有意义，这一行应该标成「待核」，不参加排序。模型也要照这条规则处理：同款只有一条、或者零售参照里没有同款时，`markup` 留空。

## 价差倍数不等于毛利：佣金、平台费和各国进口税

价差倍数只回答一件事：当地同类商品的线上零售价是 1688 同款进价的几倍。卖家拿到手的钱还要先扣平台费，再扣头程、尾程运费和进口环节的税。这些项目各国、各类目都不一样。下面是各站的公开规则，不是税务意见，用来说明价差倍数为什么要留足余量。

先看平台费。TikTok Shop 马来西亚站在 2026 年 10 月 16 日发布公告，从 10 月 31 日 00:00（马来西亚时间）起调整 Marketplace 和 Mall 的佣金率，公告写明只按成交收佣、不加新的固定费或月费，佣金按「商品价减卖家折扣」乘以类目费率计算（[TikTok Shop 马来西亚卖家中心：佣金与卖家费用](https://seller-my.tiktok.com/university/essay?knowledge_id=6907739532281602&lang=en)）。同一站点另有交易手续费 3.78%（含 SST）和每单 RM 0.54 的平台支持费（[TikTok Shop 马来西亚：Platform Support Fee](https://seller-my.tiktok.com/university/essay?knowledge_id=7992113007347457&lang=en)）。菲律宾站的费用页列得更细：交易手续费 2.24%，运费服务费 Mall 5%、Marketplace 5.5%（每件封顶 PHP 100），每单固定 PHP 5 的订单处理费，再加按类目 1% 或 1.5% 的卖家成长费（[TikTok Shop 菲律宾卖家中心：Seller Fees](https://seller-ph.tiktok.com/university/essay?knowledge_id=2675772847064834&lang=en)）。把菲律宾站这几项加起来，佣金之外每单固定扣掉的比例就有 8.2% 到 9.2%，还没算类目佣金本身。

再看进口环节。马来西亚对网上售卖、从境外寄入、单件不超过 RM 500 的低价值商品征 10% 销售税，2024 年 1 月 1 日起施行（[马来西亚财政部新闻稿](https://www.mof.gov.my/portal/en/news/press-release/sales-tax-on-imported-low-value-goods-sold-online)）。新加坡对境外卖家卖给本地消费者的低价值商品征 GST，境外卖家全球营业额和对新加坡的此类销售分别超过门槛就要注册（[新加坡税务局：境外企业的远程服务和低价值商品](https://www.iras.gov.sg/taxes/goods-services-tax-(gst)/gst-and-digital-economy/overseas-businesses)）。泰国从 2026 年 1 月 1 日起，所有经网购进口的商品不论金额都要缴 7% 增值税和进口关税，取消了 1,500 泰铢以下的免税额度（[泰国政府公共关系厅](https://thailand.prd.go.th/en/content/category/detail/id/2078/iid/440097)）；2026 年 11 月 10 日泰国内阁又批准对经电商平台进口的商品征收不超过 30% 的关税，海关预计明年生效（[路透社，2026-11-10](https://www.reuters.com/business/retail-consumer/thailand-approves-tax-increase-e-commerce-imports-finance-minister-says-2026-11-10/)）。越南从 2025 年 2 月 18 日起取消经快递进口、价值 100 万越南盾以下商品的增值税和进口税豁免（[VietNamNet](https://vietnamnet.vn/en/vietnam-ends-tax-free-status-for-low-value-imports-sent-via-express-services-2360167.html)）。印度尼西亚的跨境电商规定要求境外卖家直接卖给消费者的商品每件离岸价不低于 100 美元（[美国商务部国别指南：印尼电子商务](https://www.trade.gov/country-commercial-guides/indonesia-ecommerce)），这让印尼站的低价热卖品基本走不了「从中国直发」这条路，本文的真调也就没有选印尼站。

![堆叠柱状图：不算类目佣金时已知的百分比费用和税。马来西亚是 3.78% 交易费加 10% 低价值进口销售税，共 13.78%；菲律宾是 2.24% 交易费、5.5% 运费服务费和 1.5% 增长费，共 9.24%；泰国只画了 7% 增值税，不含关税。](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-fees-bar.zh.light.svg)

| 站点 | 本文用到的公开规则 | 生效或公布日期 | 对价差倍数的影响 |
| --- | --- | --- | --- |
| 马来西亚 | 类目佣金调整；交易手续费 3.78%；每单 RM 0.54；境外低价值商品 10% 销售税 | 2026-10-31；2024-01-01 | 佣金和税都按售价比例扣，倍数要先打折 |
| 菲律宾 | 交易手续费 2.24%；运费服务费 5%–5.5%；每单 PHP 5；卖家成长费 1%–1.5% | 2025-01-15 起的费用结构 | 固定比例约 8.2%–9.2%，再加类目佣金 |
| 泰国 | 网购进口全额征 7% 增值税和关税；内阁批准最高 30% 电商进口关税 | 2026-01-01；2026-11-10 批准 | 直发模式的税负明年可能再升 |
| 越南 | 快递进口低价值商品不再免增值税和进口税 | 2025-02-18 | 小件直发也要算税 |
| 印尼 | 境外卖家直售每件离岸价不低于 100 美元 | 2023 年起 | 低价品不能从境外直发 |

具体到一件商品，要看它归哪个类目、你是本地店还是跨境店、走哪种物流，这些都要回到各平台的卖家中心和各国海关原文核对。表里的数能说明的只有一点：东南亚站售价是 1688 进价的 2 倍时，扣完佣金、平台费、运费和税，通常所剩无几；价差倍数要到 4 倍、5 倍以上，后面的账才有空间。

## Gemini 这一侧：四个功能各管一段

Gemini 在这条链上做四件事：调接口取数、看图判同款、把结果填进固定格式的表、一次读完整批数据。每件事都对应 Gemini API 文档里的一个功能，下面逐个落到原文，读取日期都是 2026 年 11 月 18 日。

第一件是调接口。Gemini 的 Interactions API 可以直接挂远程 MCP 服务器，在 `tools` 里写一个 `type` 为 `mcp_server` 的对象，给出 `name` 和 `url` 就行（[Gemini API 文档：Remote MCP](https://ai.google.dev/gemini-api/docs/function-calling#mcp)）。同一节写了两条限制：只支持 Streamable HTTP 传输，不支持 SSE；服务器名里不要有连字符，要用下划线。字段表里还有两个对接数据接口时用得上的字段：`headers` 会随每次请求发给 MCP 服务器，用来放鉴权头；`allowed_tools` 限定模型能调这台服务器上的哪几个工具。EveryInfra 的远程 MCP 在 `https://api.everyinfra.com/mcp`，传输方式是 Streamable HTTP（[MCP 规范：Transports](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports)），2026 年 11 月 18 日 00:19 新加坡时间我们发了一次 `initialize`，0.140 秒返回，协商出的协议版本是 `2025-06-18`（[MCP 规范：Lifecycle](https://modelcontextprotocol.io/specification/2025-06-18/basic/lifecycle)）；紧接着的 `tools/list` 回了 12 个工具。选品这件活只用得上其中 3 个：`everyinfra_list_capabilities` 查能力和价格，`everyinfra_call_api` 负责取数，`everyinfra_get_job` 读异步任务，三个里只有第二个扣费。把 `allowed_tools` 写成这 3 个，模型就碰不到工单、账户设置这类和选品无关的工具。用 Gemini 托管代理挂同一个远程 MCP 做品牌监测的写法，见我们之前的一篇（[Gemini Managed Agents 挂远程 MCP 做品牌监测](/blog/gemini-managed-agents-remote-mcp-brand-monitoring)）；用 ChatGPT 代理每周盯 Shopee 选品的做法见 [ChatGPT Agent 每周做 Shopee 选品](/blog/chatgpt-agent-shopee-weekly-product-research)。

| 工具 | 做什么 | 扣费 | 放进 `allowed_tools` |
| --- | --- | --- | --- |
| `everyinfra_list_capabilities` | 列能力、参数和 `price_usd` | 否 | 是 |
| `everyinfra_call_api` | 调一项数据能力，如热卖榜、以图搜 | 按目录价 | 是 |
| `everyinfra_get_job` | 读异步任务的结果 | 否 | 是 |
| `everyinfra_get_account` | 查余额和账户信息 | 否 | 否 |
| `everyinfra_create_ticket` | 开工单 | 否 | 否，要先问人 |

![截图：Gemini API 文档 Remote MCP 一节，上方两条限制写着只支持 Streamable HTTP、服务器名不要带连字符，下方字段表列出 type、name、url、headers、allowed_tools；两条限制和 headers、allowed_tools 两行用青绿框标出。](https://everyinfra.com/articles/tiktok-shop-scraper-api/img-gemini-mcp-doc.webp)

Gemini 挂远程 MCP 只要一个 mcp_server 对象；鉴权头放 headers，能调哪些工具用 allowed_tools 限定。截于 2026 年 11 月 18 日。 [Gemini API 文档](https://ai.google.dev/gemini-api/docs/function-calling#mcp)

第二件是看图。Gemini 的图片理解支持在一次请求的 `input` 里放多张图，每张图用 `uri` 指向一个公开地址，文档给的例子就是「这两张图有什么不同」（[Gemini API 文档：图片理解](https://ai.google.dev/gemini-api/docs/image-understanding)）。同一页的限制一节写着：一次请求最多 3,600 张图；两边都不超过 384 像素的图按 258 个 token 计，更大的图切成 768×768 的块，每块 258 个 token。TikTok Shop 热卖榜和 1688 图搜回来的都是商品主图地址，一张 TikTok 主图加 5 张 1688 候选图，正好是一次请求里的 6 张图。

第三件是固定格式。结构化输出让模型的回答按你给的 JSON Schema 生成，文档的用途清单第一条就是数据提取，第二条是按预设类别分类（[Gemini API 文档：结构化输出](https://ai.google.dev/gemini-api/docs/structured-output)）。在 Interactions API 里写法是 `response_format` 里放 `mime_type: application/json` 和 `schema`；Python SDK 可以直接传 Pydantic 模型生成的 schema（[Pydantic 文档](https://docs.pydantic.dev/latest/)）。选品表的列是固定的：TikTok 商品 id、站点、售价、销量、1688 候选 id、是否同款、同款的进价、价差倍数。用 schema 把「是否同款」限定成 `same`、`similar`、`different` 三个枚举值，下游脚本就不用去解析一段自由文字。

第四件是一次读完。Gemini 4 Hydrogen 的上下文窗口是 1,048,576 个 token（[Gemini 4 Hydrogen 模型页](https://ai.google.dev/gemini-api/docs/models/gemini-4-hydrogen)），输入、思考和输出 token 共用这个窗口（[Gemini API 文档：长上下文](https://ai.google.dev/gemini-api/docs/long-context)）。本文 16 次成功调用（视频搜、以图搜、关键词搜、Google 购物、淘宝）的结果合计约 231 KB，按每 4 字节一个 token 粗算约 5.8 万 token，一次放得下。

| Gemini 功能 | 文档写的要点 | 在选品链上管哪一段 |
| --- | --- | --- |
| Remote MCP（`mcp_server`） | 只支持 Streamable HTTP；名字用下划线；`headers` 放鉴权；`allowed_tools` 限工具 | 调 EveryInfra 取热卖榜、图搜、关键词搜 |
| 多图输入 | 一次最多 3,600 张图；≤384 像素一张 258 token | 1 张 TikTok 主图对 5 张 1688 候选图判同款 |
| 结构化输出（`response_format`） | 按 JSON Schema 生成，可用 Pydantic 定义 | 把判断结果填成固定列的选品表 |
| 1M 上下文 | Gemini 4 输入、思考、输出共用 1,048,576 token | 四个站点的数据一次读完、横向比较 |
| Batch API | 付费档按标准价五折，异步返回 | 每天定时跑的大批量判同款 |

模型选哪个，看价格页。Gemini 4 Hydrogen 在 2026 年 11 月 12 日正式发布，免费档可用，付费档每百万输入 token $1.50、输出 $7.50（[Gemini API 发布说明，2026-11-12](https://ai.google.dev/gemini-api/docs/changelog#11-12-2026)）；Batch 档减半，输入 $0.75、输出 $3.75（[Gemini API 定价](https://ai.google.dev/gemini-api/docs/pricing)）。更便宜的 Gemini 3.5 Flash-Lite 每百万输入 $0.30、输出 $2.50，定价页给它的定位是高频的 agent 任务、翻译和简单数据处理（[Gemini 3.5 Flash-Lite 模型页](https://ai.google.dev/gemini-api/docs/models/gemini-3.5-flash-lite)）。Google 在发布文里说 Hydrogen 遇到工具调用失败或搜索返回空结果时能「干净地调整」，并且会并行批量发读取和搜索调用（[Google 博客：Introducing Gemini 4 Hydrogen](https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-hydrogen/)）。这两点在这条链上都会用到：本文测试期间 TikTok Shop 榜单接口一直返回 503 的经历，就是模型要学会处理的「工具调用失败」。

## 把 EveryInfra 挂进 Gemini：配置示例

下面这段是配置示例：写法照 Gemini API 文档 2026 年 11 月 18 日的版本，我们没有开 Gemini 的付费项目，这段代码在 Gemini 一侧没有实际运行；EveryInfra 一侧的地址、工具名和鉴权方式都是真调核过的。

```text
# 配置示例：Gemini 一侧未实际运行，写法照 ai.google.dev 2026-11-18 的文档
import os
from typing import Literal
from google import genai
from pydantic import BaseModel, Field

class Row(BaseModel):
    tiktok_id: str
    market: Literal["MY", "PH", "TH", "VN", "SG"]
    price_usd: float = Field(description="TikTok Shop 售价，按当日汇率折成美元")
    sold_count: int | None
    candidate_id: str | None = Field(description="1688 候选商品 id")
    match: Literal["same", "similar", "different", "no_candidate"]
    cost_usd: float | None = Field(description="同款时的 1688 列表价，折成美元")
    markup: float | None = Field(description="price_usd / cost_usd，只在 match=same 时填")

class Sheet(BaseModel):
    rows: list[Row]

client = genai.Client()  # 读环境变量 GEMINI_API_KEY

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input=(
        "取 TikTok Shop 马来西亚和菲律宾站的热卖榜各 20 个；"
        "对榜上前 3 个标准化小商品，用商品主图在 1688 以图搜同款；"
        "逐个看图判断是否同款，填进表格。只在 match=same 时计算 markup。"
    ),
    tools=[{
        "type": "mcp_server",
        "name": "everyinfra",                      # 文档要求不用连字符
        "url": "https://api.everyinfra.com/mcp",   # Streamable HTTP
        "headers": {"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
        "allowed_tools": ["everyinfra_list_capabilities", "everyinfra_call_api", "everyinfra_get_job"],
    }],
    response_format={"type": "text", "mime_type": "application/json", "schema": Sheet.model_json_schema()},
)
sheet = Sheet.model_validate_json(interaction.output_text)
```

三处要注意。`name` 写成 `everyinfra`，不要写 `every-infra` 或带连字符的名字，文档在限制里点名了这一条。Key 从环境变量读，写进 `headers`，不要写死在代码里。`allowed_tools` 只放三个工具，其中只有 `everyinfra_call_api` 扣费；模型在开始之前可以先调免费的 `everyinfra_list_capabilities` 查参数和价格，这一步不花钱。

不经过 Gemini、直接用 REST 取同样的数据，是下面这条 `curl`。本文所有真调都是这么发的，Key 只经环境变量注入：

```bash
curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"tiktok","action":"shop_hot_products","params":{"country":"MY","limit":20}}'
```

返回体里 `results` 是商品列表，每行有 `rank`、`id`、`url`、`name`、`price`、`original_price`、`currency`、`sold_count`、`rating`、`review_count`、`shop_name`、`shop_id`、`image_url`，和目录里 `response_fields` 列的一致；`billing.charged_usd` 是这次实扣的美元数。失败时返回 503，`billing.charged` 为 `false`，`charged_usd` 为 0，错误对象里带 `retry_after` 秒数（HTTP 503 的语义见 [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110#name-503-service-unavailable)）。

上面几条规则可以合成一段系统指令，放在 Interactions API 的 `system_instruction` 参数里（[Gemini API 文档：文本生成](https://ai.google.dev/gemini-api/docs/text-generation#system-instructions)）。同一页写明 Gemini 4 和 3.6 以上的模型会忽略自定义的 `temperature`、`top_p`、`top_k`，所以想让判定更稳，要把规则写清楚，调采样参数没有作用。下面是我们按本文判定规则写的一版，英文写给模型，中文读者对照上文各节即可：

```text
You build a sourcing sheet. Rules:
1. Call everyinfra_list_capabilities once before any paid call. Use only capabilities with available=true.
2. Best-seller lists: tiktok/shop_hot_products, limit 20, one call per market.
3. If a tool result has error.retryable=true, wait error.retry_after seconds and retry at most error.max_retries times.
   If it still fails, mark that market "not fetched" and continue. Never invent numbers.
4. Skip branded items. For each generic item, call alibaba1688/image_search with its image_url.
5. Compare the TikTok image with the 5 candidates. match = same only if shape, structure,
   accessories and main colours all agree; similar if same type and function but visibly different; else different.
6. Keyword for alibaba1688/search: product type plus one or two key features, in Chinese, no brand, no sale words.
7. Convert prices with the rates given in the input. markup = price_usd / cost_usd, only when match = same.
```

## 一次完整的往返：成功的样子和失败的样子

### 成功的那一次：返回里有什么

2026 年 11 月 18 日 00:16:32（新加坡时间），我们用 REST 调了一次 `alibaba1688/search`，关键词「磁吸手机支架」，`sort` 为 `popular`，`limit` 为 20。返回 HTTP 200，`count` 为 20，`billing.charged_usd` 为 0.002778，和目录价一致。20 条结果的 `price_min` 从 2.6 元到 47 元，中位数 18.9 元；`order_count` 从个位数到 80,240 不等，发货城市集中在深圳、东莞、广州和汕头。第二条是一款车载支架，标价 11 元、起订 1 件、成交 80,240 笔，这类「成交笔数高、起订量低」的条目适合拿来做小批量试单。

![截图：一次 alibaba1688/search 调用的请求和返回。请求体是 platform alibaba1688、action search、关键词磁吸手机支架、按 popular 排序、20 条；返回 status_code 200、count 20，列出两条商品的 id、标题、price_min、币种 CNY、起订量、成交笔数、城市和商家类型，billing 里 charged_usd 0.002778 用青绿框标出。](https://everyinfra.com/articles/tiktok-shop-scraper-api/img-api-1688.webp)

一次真实的 1688 关键词搜：20 条结果，扣费 0.002778 美元，和目录价一致。2026 年 11 月 18 日 00:16 新加坡时间。 [EveryInfra API 实测](https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688)

对 Gemini 来说，这一段返回要用的只有几个字段：`id` 和 `url` 用来回查，`price_min` 和 `currency` 用来算进价，`min_order_quantity` 判断能不能小批量拿货，`order_count` 看这款货在批发端走得动不动。把这几个字段写进结构化输出的 schema，模型就不会把标题里的促销字样当成价格。

### 失败的那一次：模型会看到什么

2026 年 11 月 18 日 00:38:09（新加坡时间），我们按 MCP 协议向 `https://api.everyinfra.com/mcp` 发了一次 `tools/call`，工具是 `everyinfra_call_api`，参数和 Gemini 在配置示例里会发出的一样：`platform` 为 `tiktok`，`action` 为 `shop_hot_products`，`params` 为菲律宾站、20 条。那一刻 TikTok Shop 几项能力正在出错，返回里 `isError` 为 `true`，第一段文字写着服务暂时不可用并附 request_id；第二段是计费，`charged` 为 `false`、`charged_usd` 为 0，`refund.status` 为 `succeeded`；第三段是给模型看的下一步提示：10 分钟内这项能力失败了 5 次、一次都没扣钱，如果用户的其他目标也这样失败，问题在服务端，先问用户要不要开工单，用户同意才调 `everyinfra_create_ticket`。`structuredContent.error` 里还有机器可读的 `retryable: true`、`retry_after: 60`、`max_retries: 2`。

| 返回里的字段 | 这一次的值 | 模型该怎么用 |
| --- | --- | --- |
| `isError` | `true` | 这一步没拿到数据，不能往表里填数 |
| `billing.charged` / `charged_usd` | `false` / 0 | 没扣钱，重试不会重复计费 |
| `refund.status` | `succeeded` | 预扣的金额已退回 |
| `structuredContent.error.retryable` | `true` | 可以重试 |
| `structuredContent.error.retry_after` | 60 | 等 60 秒再试 |
| `structuredContent.error.max_retries` | 2 | 最多再试 2 次，然后标「未取到」 |

## 费用：每 100 个商品多少钱

数据这一侧按目录的 `price_usd` 算。热卖榜每次 20 条、0.000806 美元，100 个商品要取 5 次，合 0.0040 美元；1688 以图搜每次 0.005556 美元，100 个商品 0.56 美元；1688 关键词搜每次 0.002778 美元，100 次 0.28 美元；淘宝关键词搜每次 0.0135 美元，100 次 1.35 美元，所以只给少数商品调。失败和空结果不扣费，本文测试期间 TikTok Shop 那几十次 503 一分钱没扣。

本文全部真调一共 88 次，合计扣费 0.0574 美元，按能力分开如下表。一半以上花在 1688 以图搜上；TikTok Shop 榜单类的 503 一次都没扣钱。

| 能力 | 调用次数 | 成功 | 扣费（美元） |
| --- | --- | --- | --- |
| 1688 以图搜（`alibaba1688/image_search`） | 6 | 6 | 0.033336 |
| 淘宝关键词搜（`taobao/search`） | 1 | 1 | 0.0135 |
| 1688 关键词搜（`alibaba1688/search`） | 2 | 2 | 0.005556 |
| Google 购物（`google_shopping/search`） | 5 | 5 | 0.00278 |
| TikTok 视频搜索（`tiktok/search`） | 4 | 4 | 0.002224 |
| TikTok Shop 榜单类（热卖榜、类目、店内搜索、MCP） | 70 | 0 | 0 |
| **合计** | 88 | 18 | 0.0574 |

模型这一侧是估算，我们没有在 Gemini 上实际跑。每个商品送 6 张图：1 张 TikTok 主图加 5 张 1688 候选图。我们量了 5 张 1688 主图，原图是 800 到 1,920 像素的正方形；按文档的分块公式，这样的图每张算 4 块、1,032 个 token。在 1688 图片地址后面加 `_300x300.jpg` 就能拿到 300 像素的缩略图，两边都不超过 384 像素，每张只算 258 个 token（[Gemini API 文档：图片理解](https://ai.google.dev/gemini-api/docs/image-understanding)）。文字部分按每个商品 800 个输入 token、150 个输出 token 和 500 个思考 token 估；价目页每个模型的输出价一栏都注明「含思考 token」（[Gemini API 定价](https://ai.google.dev/gemini-api/docs/pricing)）。

![分组柱状图：我们量的 5 张 1688 主图，原图尺寸 1920、800、1080、1200、1000 像素，文件 120 到 363 KB，每张按文档公式算 1,032 token；加 _300x300.jpg 后缀后都是 300 像素，文件 17 到 44 KB，每张 258 token。](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-tokens-bar.zh.light.svg)

![横向条形图：每 100 个商品走完一遍的费用。数据侧 TikTok 热卖榜 0.0040 美元、1688 以图搜 0.56 美元、1688 关键词搜 0.28 美元、淘宝关键词搜 1.35 美元；模型侧 Gemini 4 Hydrogen 用原图 1.54 美元、用 300 像素缩略图 0.84 美元，Hydrogen 批处理加缩略图 0.42 美元，Gemini 3.5 Flash-Lite 加缩略图 0.23 美元。](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-cost-bar.zh.light.svg)

| 每 100 个商品 | 输入 token | 输出 token（含思考） | 费用（美元） |
| --- | --- | --- | --- |
| Gemini 4 Hydrogen，原图 | 699,200 | 65,000 | 1.54 |
| Gemini 4 Hydrogen，300 px 缩略图 | 234,800 | 65,000 | 0.84 |
| Hydrogen 批处理，300 px 缩略图 | 234,800 | 65,000 | 0.42 |
| Gemini 3.5 Flash-Lite，300 px 缩略图 | 234,800 | 65,000 | 0.23 |
| EveryInfra：热卖榜 + 1688 以图搜 + 1688 关键词搜 | — | — | 0.84 |

把图换成缩略图，Hydrogen 的输入 token 少了三分之二，费用从 1.54 美元降到 0.84 美元；再走批处理减半到 0.42 美元。数据费和模型费加起来，按批处理加缩略图算，每 100 个商品大约 1.26 美元，其中 0.56 美元是 1688 以图搜，占四成多。Hydrogen 还在免费档里，量小的时候可以先用免费档试规则，免费档的速率限制见 [Gemini API 速率限制](https://ai.google.dev/gemini-api/docs/rate-limits)。

## 每天跑一遍：用 sold_count 的增量找正在起量的商品

热卖榜给的 `sold_count` 是店铺页上显示的累计销量，一个卖了两年的老款和一个上周才起量的新款，累计数可能差不多。要看「现在卖得快不快」，得在两个时刻各取一次榜，用差值算。2026 年 11 月 18 日在 YouTube 视频搜索里搜关键词「tiktok shop scraper」，排前三的视频演示了两个做法：一是让模型按「销量 × 售价」估算营收再排序，二是把同一个商品隔 24 小时各取一次，用差值估算日销。Viktor Automates 在 2026 年 10 月 22 日的视频里，在 ChatGPT 里接上自定义 MCP 后用定时任务每天跑一次（[Build Your Own TikTok Shop Scraper In ChatGPT, YouTube](https://www.youtube.com/watch?v=lLUydphbjIo)）；一位抓取 API 作者在 2025 年 8 月的视频里演示的是美国站，作者说网页上一次搜索要 20 到 30 秒，验证页也常见（[Unofficial TikTok Shop API, YouTube](https://www.youtube.com/watch?v=9s8ylkAiipg)）。这三个视频都只做美国站，没有一个往下接 1688 或淘宝找货源。

| 视频 | 频道与日期 | 覆盖站点 | 演示的做法 |
| --- | --- | --- | --- |
| Build Your Own TikTok Shop Scraper In ChatGPT | Viktor Automates，2026-10-22 | 美国 | ChatGPT 接自定义 MCP，定时任务每天跑 |
| Unofficial TikTok Shop API | 一位抓取 API 作者的频道，2025-08-15 | 美国 | 用接口代替网页抓取；网页一次搜索 20 到 30 秒，常遇验证页 |
| TikTok Shop Scraper: Find What's Actually Selling | 一家抓取平台的频道，2026-08-07 | 美国 | 按销量乘售价估营收排序 |

### 隔 40 分钟再取一次，变了什么

我们在唯一正常的 TikTok 数据源上试了「取两次、做差」这一步。00:53 和 01:33（新加坡时间）各用 `tiktok/search` 取一次「tiktok shop malaysia」的 20 条视频，两次都出现的只有 11 条，另外 9 条是新面孔；这 11 条里有 10 条换了位置，所以搜索结果算不上一张固定名单。我们挑中的感应小飞仙和按摩拖鞋，就在掉出去的 9 条里。

数字的变化比顺序小。11 条里播放数变了的只有 4 条，点赞数变了的也是 4 条。三份视频文件里，一万以上的播放数末两位全是 00，可见大数是取整后的值，40 分钟里不到 100 的增长看不出来；一万以下的点赞数看起来是精确值，相机风扇的播放数停在 999,800，点赞从 5,868 变成了 5,869。

| 视频（马来西亚） | 位置 00:53 → 01:33 | 播放 00:53 → 01:33 | 点赞 00:53 → 01:33 |
| --- | --- | --- | --- |
| `#BarangViral` 带货视频 | 6 → 15 | 456,300 → 458,500 | 1,876 → 1,888 |
| 白色牛仔裤 | 4 → 6 | 331 → 369 | 47 → 49 |
| `#goodthing` 带货视频 | 5 → 11 | 384,700 → 385,200 | 1,439 → 1,441 |
| 相机造型风扇 | 13 → 4 | 999,800 → 999,800 | 5,868 → 5,869 |
| `#setperiuk` 锅具套装 | 2 → 8 | 1,000,000 → 1,000,000 | 4,133 → 4,133 |
| 环形灯带桌面风扇 | 19 → 17 | 3,200,000 → 3,200,000 | 16,900 → 16,900 |

这和下面两条规则对得上：按 `id` 对，不按名次对；差值隔 24 小时取，让取整后的数有时间动起来。01:33 我们还顺手再调了一次马来西亚热卖榜，仍是 503、没扣费，TikTok Shop 榜单类的失败累计到 70 次。

放进日常流程时，有三点要定死。第一，取榜时间固定，比如每天新加坡时间上午 10 点，两次之间的间隔一致，增量才能互相比较。第二，按商品 `id` 对齐，不按名次对齐；名次会变，`id` 不变。第三，增量只是排序依据，不直接当日销：店铺可能把多个规格合并显示，也可能在大促后修正销量。把增量排前 10 的商品交给以图搜那一步，其余的只记录不处理，费用就能压在每天几美分。

如果让 Gemini 来跑这一步，可以用 Batch API 把每天的比对任务排进批处理，文档写明批处理按标准价的一半计费，目标是 24 小时内返回结果，多数任务更快（[Gemini API 文档：Batch API](https://ai.google.dev/gemini-api/docs/batch-api)）。选品不需要秒级响应，第二天早上拿到结果就够用。

## 做不了或要注意的地方

第一，TikTok Shop 的热卖榜只有 8 个站点有。目录写明 `tiktok/shop_hot_products` 支持印尼、日本、墨西哥、马来西亚、菲律宾、新加坡、泰国、越南，美国、英国、巴西站没有热卖榜，传了会在扣费前被拒（[EveryInfra 目录：TikTok](https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok)）。做美国站要换成 `tiktok/shop_category_products` 按类目取，或者用 `tiktok/shop_search` 按关键词取。

第二，店铺商品暂时取不到。目录里 `tiktok/shop_products` 标着暂停，调用会直接返回 503、不扣费，所以本文没有用「先找到热卖店铺、再翻它的全部商品」这条路。这一项恢复以前，要看一家店卖什么，只能从热卖榜和类目榜里按 `shop_id` 筛。

第三，1688 图搜一次只回 5 个候选，而且目录写明它不返回完整 SKU、库存和商家详情（[EveryInfra 目录：1688](https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688)）。判定为同款以后，要拿候选的链接再调一次 `alibaba1688/product_detail`（每次 $0.001389）取阶梯价和起订量，这一步本文没有做，所以文中的「进价」是图搜或关键词搜索返回的列表价，不是你下单量对应的阶梯价。

第四，淘宝搜索带价格筛选或按销量排序时不能翻页，最多 10 到 20 条；普通关键词搜索能翻页，但多数行没有销量和店铺名（[EveryInfra 目录：淘宝](https://api.everyinfra.com/api/v1/social/catalog?platform=taobao)）。淘宝价是零售价，用来看「国内零售市场把这件东西卖到多少钱」，不能当进价。

第五，TikTok Shop 的 `sold_count` 是平台前台展示的累计销量，不是某一天的销量；要估日销，要像下一节那样隔一段时间再取一次，用差值算。

第六，模型判同款会出错。Gemini 文档的最佳实践写着图片要摆正、要清晰，单图配文字时把文字放在图前面（[Gemini API 文档：图片理解](https://ai.google.dev/gemini-api/docs/image-understanding)）；商品主图常带文字海报和拼图，这一步要让模型给出 `similar` 这一档，再由人复核，不能把 `similar` 当成同款去算价差。本文的 30 个判定只由作者一人看图完成；放进日常流程前，可以让 Gemini 在看不到人工判定的情况下，对同样 30 组图盲判一遍，两边不一致的再由人复核，用这个一致率决定哪些品类可以放手交给模型。

第七，不碰合规风险高的类目。TikTok Shop 马来西亚站的禁售商品指引列了不能卖、不能进口的商品类别（[TikTok Shop 马来西亚：禁售商品指引](https://seller-my.tiktok.com/university/essay?knowledge_id=8927861016708866&lang=en)），带电池、液体、化妆品的商品在跨境物流和各国认证上还有额外要求。价差再大，这些类目都要先过合规这一关。

## 最近 60 天的变化

| 日期 | 变化 | 对用这条链选品的人意味着什么 | 出处 |
| --- | --- | --- | --- |
| 2026-10-16 | TikTok Shop 马来西亚站公告 10 月 31 日起调整类目佣金 | 10 月 31 日前后下单的佣金不同，价差表里的平台费要按新费率重算 | [卖家中心公告](https://seller-my.tiktok.com/university/essay?knowledge_id=6907739532281602&lang=en) |
| 2026-10-29 | 马来西亚本地中小卖家在 9.9 大促期间销售额同比增长 140%，近六成用户偏好直播购物 | 热卖榜上本地卖家和直播带货的商品会更多，跨境直发的商品要和它们比价 | [The Rakyat Post](https://www.therakyatpost.com/news/2026/10/29/tiktok-shop-live-becomes-digital-shopfront-for-malaysian-msmes-as-local-sellers-record-140-sales-growth/) |
| 2026-11-05 | TikTok 在新加坡、马来西亚、泰国、菲律宾上线独立的 TikTok Shop 应用 | 四个站点的购物入口多了一个，热卖榜反映的成交会更集中在这四个站 | [TechCrunch](https://techcrunch.com/2026/11/05/tiktok-quietly-launches-a-standalone-tiktok-shop-app/) |
| 2026-11-10 | 泰国内阁批准对电商进口商品征收最高 30% 的关税 | 从中国直发泰国的低价商品，明年的税负可能再升一档 | [路透社](https://www.reuters.com/business/retail-consumer/thailand-approves-tax-increase-e-commerce-imports-finance-minister-says-2026-11-10/) |
| 2026-11-10 | 菲律宾 11.11 购物节，消费者转向内容创作者和带货达人下单 | 热卖榜和达人带货强相关，选品时要连同带货视频一起看 | [The Manila Times](https://www.manilatimes.net/2026/11/10/news/filipino-shoppers-pivot-to-content-creators-for-1111/2466071) |
| 2026-11-12 | Gemini 4 Hydrogen 正式发布，免费档可用，付费档每百万输入 $1.50 | 这条链上的模型默认可以换成 Hydrogen，成本按新价重算 | [Gemini API 发布说明](https://ai.google.dev/gemini-api/docs/changelog#11-12-2026) |
| 2026-11-13 | GitHub Copilot 上线 Gemini 4 Hydrogen | 在编辑器里写选品脚本时也能直接用同一个模型 | [GitHub Changelog](https://github.blog/changelog/2026-11-13-gemini-4-hydrogen-in-github-copilot/) |

两条和钱直接相关的变化都发生在 10 月底到 11 月中：马来西亚站的佣金在 10 月 31 日换了表，泰国的电商进口关税在 11 月 10 日过了内阁。一张价差表如果是 10 月做的，现在至少要重算平台费那一列；直发泰国的品，明年的进口税还没定稿，表里先按现行的 7% 增值税加关税算，新规生效后再改。

## 上手步骤

1. 打开免费目录 `https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok`，确认 `shop_hot_products`、`shop_category_products` 的 `available` 为 true，记下 `price_usd`。
1. 在 [快速上手](/docs#quickstart) 里注册、充值、拿到 Key；Key 放进环境变量 `EVERYINFRA_API_KEY`。
1. 先用上面的 `curl` 取一个站点的热卖榜，确认返回 20 行、`charged_usd` 为 0.000806。
1. 挑一个标准化小商品，把它的 `image_url` 传给 `alibaba1688/image_search`，看 5 个候选里有没有同款。
1. 在 Gemini 里按上一节的配置挂上远程 MCP，让模型把同样的流程跑一遍，并按 schema 交回表格；结果和你手动跑的对一遍。
1. 想每天跑，就把第 3、4 步写成定时任务，每天同一时间取一次热卖榜，用 `sold_count` 的差值看谁在涨。更多接入方式见 [远程 MCP 配置](/mcp-server) 和 [数据市场](/market)。

## 常见问题

### TikTok 有官方 API 能取 TikTok Shop 商品吗？

「does tiktok have an api」是「tiktok shop scraper api」的 Google 联想词之一。TikTok 有两类官方接口，都不是给选品用的。TikTok Shop 的 Partner Center 开放 API 面向已入驻的卖家和服务商，管的是自己店铺的商品、订单和物流（[TikTok Shop 开发者指南](https://partner.tiktokshop.com/docv2/page/656559fcf4488c02dfe8ce82)）。TikTok 的 Research API 里有一个查 TikTok Shop 店铺的接口，要申请研究资格，文档写明返回的是在欧盟经营的店铺，一次最多 10 条（[TikTok 开发者文档：TikTok Shop Details API](https://developers.tiktok.com/doc/research-api-specs-query-tiktok-shop-info)）。要看东南亚站的公开热卖榜和类目榜，就要用 `tiktok/shop_hot_products`、`tiktok/shop_category_products` 这类取公开页面数据的接口。

### tiktok shop scraper github 上的开源项目能直接用吗？

「tiktok shop scraper github」也是联想词。开源项目适合学习页面结构，拿来天天跑要自己处理代理、验证和页面改版。一段公开的 YouTube 讲解里，作者演示自己的 TikTok Shop 接口时说一次搜索要 20 到 30 秒，页面频繁弹出验证（[Unofficial TikTok Shop API，YouTube](https://www.youtube.com/watch?v=9s8ylkAiipg)）。按次计费的接口把这些都包在价格里：`tiktok/shop_hot_products` 每次 $0.000806，失败不扣钱。

### tiktok shop scraper free：有没有免费的取法？

联想词里有「tiktok shop scraper free」。EveryInfra 的目录 `GET /api/v1/social/catalog` 不要 Key、不收费，能先看全部能力、参数和价格；真调要 Key，按次扣钱，返回 503 或空结果不扣。按目录价，一次 20 条的热卖榜 0.000806 美元，取 1,000 个热卖商品约 0.04 美元。

### 怎么在 1688 上以图搜同款？

Reddit 的 r/Alibaba 版块有一帖讲给海外客户在 1688 找货，作者把「按图搜索」列为最有用的办法之一，上传商品照片就能拿到几十个带价格的货源选项（[Reddit r/Alibaba](https://www.reddit.com/r/Alibaba/comments/1lxqd52/ive_helped_nonchinese_clients_source_from_1688/)）。1688 开放平台有面向分销服务商的图搜接口，要申请并上架服务市场（[1688 开放平台：图搜分销商品](https://open.1688.com/ability/detail?key=1610419169653)）。不想走申请流程，可以用 `alibaba1688/image_search`：传一张公开商品图的地址，回 5 个相似商品，每次 $0.005556。

### TikTok 上爆的商品都是从 1688 来的吗？

不一定。Reddit 的 r/dropshipping 有一帖题为「爆款 TikTok 商品其实从哪来」，楼主认为大量爆款来自义乌的实体批发市场（[Reddit r/dropshipping](https://www.reddit.com/r/dropshipping/comments/1mx9yvj/where_viral_tiktok_products_actually_come_from/)）。本文的结果部分印证了这一点：6 个商品里 4 个在 1688 找到了同款，小飞仙玩具的同款商家主要在汕头和义乌，按摩拖鞋的在揭阳和义乌；没找到同款的是一款能拍照的风扇和一件印花 T 恤，前者功能在封面上看不出来，后者的印花被别家用在了白色款和卫衣上。找不到同款不等于没有货源，只说明这件东西不适合按「图搜同款再比价」的方法去做。

### 抓取 TikTok Shop 数据合法吗？

「is it legal to scrape tiktok shop data」是联想词。本文不提供法律意见。我们能说的是本文取的数据范围：TikTok Shop 前台公开展示的商品名、价格、销量、评分和店铺名，1688、淘宝的公开商品列表；不登录任何账号，不取个人信息。你的用途是否合规，要按你所在地的法律和各平台的条款，请专业人士判断。

### tiktok shop review scraper：能取商品评价吗？

能。`tiktok/shop_product_reviews` 按商品 id 取评价，每页最多 20 条，每次 $0.000764，评价人名字是平台已打码的形式（[EveryInfra 目录：TikTok](https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok)）。选品时可以对价差大的几个商品各取一页一星、两星评价，看差评集中在质量还是物流，再决定要不要进货。

## 参考资料

1. Google AI for Developers，《Gemini Developer API pricing》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/pricing
1. Google AI for Developers，《Gemini API release notes (Nov 12, 2026: Gemini 4 Hydrogen GA)》，2026-11-12，https://ai.google.dev/gemini-api/docs/changelog#11-12-2026
1. Google AI for Developers，《Gemini 4 Hydrogen model page》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/models/gemini-4-hydrogen
1. Google AI for Developers，《Function calling: Remote MCP》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/function-calling#mcp
1. Google AI for Developers，《Structured outputs》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/structured-output
1. Google AI for Developers，《Image understanding》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/image-understanding
1. Google AI for Developers，《Long context》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/long-context
1. Google AI for Developers，《Batch API》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/batch-api
1. Google AI for Developers，《Gemini 3.5 Flash-Lite model page》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/models/gemini-3.5-flash-lite
1. Google AI for Developers，《Using tools with the Gemini API》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/tools
1. Google AI for Developers，《Files API》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/files
1. Google AI for Developers，《Thinking levels》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/thinking
1. Google AI for Developers，《Rate limits》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/rate-limits
1. Google AI for Developers，《URL context》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/url-context
1. Google blog，《Introducing Gemini 4 Hydrogen for Agentic Workflows》，2026-11-12，https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-hydrogen/
1. Ars Technica，《Google rolls out Gemini 4 Hydrogen, finally replacing 3.8 Flash》，2026-11-12，https://arstechnica.com/google/2026/11/google-rolls-out-gemini-4-hydrogen-finally-replacing-3-8-flash/
1. GitHub Changelog，《Gemini 4 Hydrogen in GitHub Copilot》，2026-11-13，https://github.blog/changelog/2026-11-13-gemini-4-hydrogen-in-github-copilot/
1. Model Context Protocol，《MCP specification: Transports (2025-06-18)》，2025-06-18，https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
1. Model Context Protocol，《MCP specification: Lifecycle (2025-06-18)》，2025-06-18，https://modelcontextprotocol.io/specification/2025-06-18/basic/lifecycle
1. GitHub googleapis/python-genai，《Google Gen AI Python SDK》，2026-11-18 读取，https://github.com/googleapis/python-genai
1. PyPI，《google-genai on PyPI》，2026-11-18 读取，https://pypi.org/project/google-genai/
1. Pydantic，《Pydantic documentation》，2026-11-18 读取，https://docs.pydantic.dev/latest/
1. EveryInfra，《EveryInfra data catalog》，2026-11-18 读取，https://api.everyinfra.com/api/v1/social/catalog
1. EveryInfra，《EveryInfra catalog: TikTok》，2026-11-18 读取，https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok
1. EveryInfra，《EveryInfra catalog: 1688》，2026-11-18 读取，https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688
1. EveryInfra，《EveryInfra catalog: Taobao》，2026-11-18 读取，https://api.everyinfra.com/api/v1/social/catalog?platform=taobao
1. TikTok Shop Malaysia Seller Center，《TikTok Shop Malaysia: Commission Fee & Seller Fees Calculations》，2026-10-16，https://seller-my.tiktok.com/university/essay?knowledge_id=6907739532281602&lang=en
1. TikTok Shop Malaysia Seller Center，《TikTok Shop Malaysia: Platform Support Fee》，2026-04-22，https://seller-my.tiktok.com/university/essay?knowledge_id=7992113007347457&lang=en
1. TikTok Shop Philippines Seller Center，《TikTok Shop Philippines: Introduction to Seller Fees》，2026-10-13，https://seller-ph.tiktok.com/university/essay?knowledge_id=2675772847064834&lang=en
1. TikTok Shop Malaysia Seller Center，《TikTok Shop Malaysia: Prohibited Products Guidelines》，2025-03-07，https://seller-my.tiktok.com/university/essay?knowledge_id=8927861016708866&lang=en
1. TikTok Shop Partner Center，《TikTok Shop developer guide》，2026-11-18 读取，https://partner.tiktokshop.com/docv2/page/656559fcf4488c02dfe8ce82
1. TikTok for Developers，《Research API: TikTok Shop Details API》，2026-11-18 读取，https://developers.tiktok.com/doc/research-api-specs-query-tiktok-shop-info
1. 1688 Open Platform，《图搜分销商品 (image search for distribution)》，2026-11-18 读取，https://open.1688.com/ability/detail?key=1610419169653
1. 1688 Open Platform，《跨境综合解决方案 (cross-border solution)》，2026-11-18 读取，https://open.1688.com/solution/solutionDetail.htm?solutionKey=1697014160788
1. Ministry of Finance Malaysia，《Sales Tax On Imported Low-Value Goods Sold Online》，2023-12-18，https://www.mof.gov.my/portal/en/news/press-release/sales-tax-on-imported-low-value-goods-sold-online
1. Inland Revenue Authority of Singapore，《Overseas businesses supplying remote services and low-value goods》，2026-09-18，https://www.iras.gov.sg/taxes/goods-services-tax-(gst)/gst-and-digital-economy/overseas-businesses
1. Thailand Public Relations Department，《Thailand to Apply Import Tax on All Online Goods from Jan '26》，2025-11-10，https://thailand.prd.go.th/en/content/category/detail/id/2078/iid/440097
1. Reuters，《Thailand approves tax increase on e-commerce imports》，2026-11-10，https://www.reuters.com/business/retail-consumer/thailand-approves-tax-increase-e-commerce-imports-finance-minister-says-2026-11-10/
1. VietNamNet，《Vietnam ends tax-free status for low-value imports sent via express services》，2025-01-05，https://vietnamnet.vn/en/vietnam-ends-tax-free-status-for-low-value-imports-sent-via-express-services-2360167.html
1. International Trade Administration, US Department of Commerce，《Indonesia - eCommerce (Country Commercial Guide)》，2025-11-17，https://www.trade.gov/country-commercial-guides/indonesia-ecommerce
1. European Central Bank，《Euro foreign exchange reference rates》，2026-11-17，https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html
1. GitHub hakanensari/frankfurter，《Frankfurter (ECB reference rate API)》，2026-11-18 读取，https://github.com/hakanensari/frankfurter
1. TechCrunch，《TikTok quietly launches a stand-alone TikTok Shop app》，2026-11-05，https://techcrunch.com/2026/11/05/tiktok-quietly-launches-a-standalone-tiktok-shop-app/
1. The Rakyat Post，《TikTok Shop LIVE Becomes Digital Shopfront For Malaysian MSMEs》，2026-10-29，https://www.therakyatpost.com/news/2026/10/29/tiktok-shop-live-becomes-digital-shopfront-for-malaysian-msmes-as-local-sellers-record-140-sales-growth/
1. The Manila Times，《Filipino shoppers pivot to content creators for 11.11》，2026-11-10，https://www.manilatimes.net/2026/11/10/news/filipino-shoppers-pivot-to-content-creators-for-1111/2466071
1. IETF / RFC Editor，《RFC 9110: HTTP Semantics, 503 Service Unavailable》，2022-06，https://www.rfc-editor.org/rfc/rfc9110#name-503-service-unavailable
1. Python documentation，《statistics — Mathematical statistics functions》，2026-11-18 读取，https://docs.python.org/3/library/statistics.html
1. Reddit r/Alibaba，《I've helped non-Chinese clients source from 1688》，2025，https://www.reddit.com/r/Alibaba/comments/1lxqd52/ive_helped_nonchinese_clients_source_from_1688/
1. Reddit r/dropshipping，《Where viral TikTok products actually come from (hint: not Alibaba) AMA》，2025，https://www.reddit.com/r/dropshipping/comments/1mx9yvj/where_viral_tiktok_products_actually_come_from/
1. YouTube，《Unofficial TikTok Shop API》，2025-08-15，https://www.youtube.com/watch?v=9s8ylkAiipg
1. YouTube, Viktor Automates，《Build Your Own TikTok Shop Scraper In ChatGPT》，2026-10-22，https://www.youtube.com/watch?v=lLUydphbjIo
1. Google AI for Developers，《Text generation: system instructions》，2026-11-18 读取，https://ai.google.dev/gemini-api/docs/text-generation#system-instructions
1. ExchangeRate-API，《ExchangeRate-API open access endpoint (USD, 2026-11-17)》，2026-11-17，https://open.er-api.com/v6/latest/USD
