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：请求 UA
PDP_MAX_RESPONSE_BYTES：最大响应体（默认 8MB）
PDP_CACHE_DIR：缓存目录
PDP_RATE_LIMIT_PER_MIN：每分钟采集上限（默认 6）
PDP_COOLDOWN_SECONDS：403/429 冷却秒数（默认 900）

合规边界（硬性）

仅采集公开、无需登录的 PDP 内容；不登录、不带 Cookie/授权头；
不绕过验证码、频控、地域限制；不抓非公开内容、个人数据；
结果只用于策略学习，禁止复制竞品图片/文案/品牌元素；
每条素材标记来源 URL、产品 ID、采集时间、顺序。

Metadata

Release files for tiktok-pdp-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tiktok-pdp-mcp 0.1.0
File	Size	Uploaded	Provenance	Actions
tiktok_pdp_mcp-0.1.0.tar.gz	8.0 kB	Aug 20, 2026	Without provenance	Details for tiktok_pdp_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tiktok-pdp-mcp 0.1.0
File	Interpreter	ABI	Platform	Actions Reset
tiktok_pdp_mcp-0.1.0-py3-none-any.whl 10.8 kB Aug 20, 2026 Without provenance	Python 3	none	any	Details for tiktok_pdp_mcp-0.1.0-py3-none-any.whl

Total release size: 18.9 kB

Release files / tiktok_pdp_mcp-0.1.0.tar.gz

Download URL	tiktok_pdp_mcp-0.1.0.tar.gz
Size	8.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`35ab0d87057adc574b45f4bda8664667695755259558872635e84b4b9be35265`
BLAKE2b-256 checksum How to use checksums	`130a176effaa24d9f2ba775b62a9b17b45a0e8abc6d456e152df6de015cc4fe9`
Upload date	Aug 20, 2026
Uploaded using Trusted Publishing? What is 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}`

Release files / tiktok_pdp_mcp-0.1.0-py3-none-any.whl

Download URL	tiktok_pdp_mcp-0.1.0-py3-none-any.whl
Size	10.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`98dc93a7f7539f80eae0bebff600eb658e0f83b8266b3b7133adc2915b8a5acf`
BLAKE2b-256 checksum How to use checksums	`5880e2ae2e2127dbf7cd03af51eda243f5935986a79d0e68625e481e20197915`
Upload date	Aug 20, 2026
Uploaded using Trusted Publishing? What is 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}`

Security for tiktok-pdp-mcp 0.1.0

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

Aug 20, 2026 2 release files No provenance

tiktok-pdp-mcp 0.1.0