tiktok-pdp-mcp
TikTok Shop PDP 公开素材采集 MCP。只读采集公开 TikTok Shop 商品详情页（PDP）的主图轮播、详情模块与可见文本，用于竞品视觉证据归档。
定位：补足 FastMoss 的量化数据。FastMoss 负责「找爆款、看销量/价格/达人」，本 MCP 负责「把选中的竞品公开页面的主图和详情模块抓下来」，供视觉拆解建立「只学策略、不复制」的原创上架方案。
工具
collect_tiktok_shop_pdp_materials —— 只读采集公开 PDP。
输入参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| market | string | 必填。v1.0 仅 US |
| pdp_url | string | 完整 PDP URL，与 product_id 二选一 |
| product_id | string | 产品 ID（10~30 位数字），与 pdp_url 二选一 |
| include_main_images | bool | 是否提取主图轮播，默认 true |
| include_detail_modules | bool | 是否提取详情模块，默认 true |
| download_images | bool | 是否下载图片，默认 false（仅返回 URL） |
| max_main_images | int | 主图上限，默认 12 |
| max_detail_modules | int | 详情模块上限，默认 30 |
| request_timeout_seconds | int | 请求超时，默认 20 |
返回 status 枚举：success / partial / access_restricted / parse_failed / invalid_input / network_error。
启动
uvx tiktok-pdp-mcp
环境变量（均可选，有安全默认值）
PDP_TIMEOUT：请求超时（默认 20）PDP_USER_AGENT：请求 UAPDP_MAX_RESPONSE_BYTES：最大响应体（默认 8MB）PDP_CACHE_DIR：缓存目录PDP_RATE_LIMIT_PER_MIN：每分钟采集上限（默认 6）PDP_COOLDOWN_SECONDS：403/429 冷却秒数（默认 900）
合规边界（硬性）
- 仅采集公开、无需登录的 PDP 内容；不登录、不带 Cookie/授权头；
- 不绕过验证码、频控、地域限制；不抓非公开内容、个人数据；
- 结果只用于策略学习，禁止复制竞品图片/文案/品牌元素；
- 每条素材标记来源 URL、产品 ID、采集时间、顺序。
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tiktok_pdp_mcp-0.1.0.tar.gz.
File metadata
- Download URL: tiktok_pdp_mcp-0.1.0.tar.gz
- Upload date:
- Size: 8.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
35ab0d87057adc574b45f4bda8664667695755259558872635e84b4b9be35265
|
|
| MD5 |
7eb577c3b13c1bea6d9e3c56e4fa47f2
|
|
| BLAKE2b-256 |
130a176effaa24d9f2ba775b62a9b17b45a0e8abc6d456e152df6de015cc4fe9
|
File details
Details for the file tiktok_pdp_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: tiktok_pdp_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 10.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
98dc93a7f7539f80eae0bebff600eb658e0f83b8266b3b7133adc2915b8a5acf
|
|
| MD5 |
5a4dbb13a82790e9a2f3b536392e6f8f
|
|
| BLAKE2b-256 |
5880e2ae2e2127dbf7cd03af51eda243f5935986a79d0e68625e481e20197915
|
