Dify插件TubeText：接入TikTok Shop与AliExpress数据

Dify 在 LLM 编排环节表现成熟，但工作流真正卡壳的地方往往是数据入口：一个商品的真实销量和库存、AliExpress 的实时价格、一段视频到底讲了什么。开发者 LMSlay 发布的开源插件 TubeText 正是为填补这个缺口而生——它把四个数据工具接进 Dify，每个工具通过你自己的 Apify token 运行对应 Actor，并返回结构化 JSON。

四个工具分别解决什么问题

TubeText 提供了四个可独立调用的工具，覆盖电商数据与内容转录两条主线。

• TikTok Shop Products：输入商品、店铺或分类链接（限美国站），输出价格、折扣、已售件数、评分、各 SKU 库存以及店铺统计。
• AliExpress Search：输入最多 20 个关键词，返回价格、销量、评分、发货国、Choice 与促销标签。
• Video Transcript：混合输入 YouTube 和 TikTok 链接，逐条返回字幕；开启 Whisper AI 后可对无字幕视频做语音转写。
• Get Run Results：输入 run ID，分页拉取耗时较长任务的最终结果。

四个工具都由 Apify Actor 驱动，插件本身只调用 api.apify.com，不会登录 TikTok、AliExpress 或 YouTube 账号，这一点对关心账号安全的团队比较友好。

Apify 与 Actor 是什么

Apify 是一个云端网页抓取与自动化平台，开发者可以把针对某个网站的采集逻辑打包成可复用的「Actor」，发布到 Apify 商店供他人按次调用。每个 Actor 封装了选择器、翻页、反爬绕过和字段清洗等细节，调用方只需提供输入参数，就能拿到结构化 JSON 输出。TubeText 本质上是一层适配器：它把 Dify 的工具调用翻译成对应的 Actor 请求，再把返回结果整理成 Dify 能消费的格式。因此插件的抓取能力、字段覆盖和稳定性，实际取决于背后 Actor 的维护情况，而不是插件本身。使用自己的 Apify token 意味着配额、计费和调用记录都归属你自己的账号，也方便在控制台排查某次 run 的原始日志。

两分钟完成配置

配置流程被压缩到三步：在 Apify 控制台的 Settings → API & Integrations 复制 API token；在 Dify Marketplace 安装 TubeText；在 Tools → TubeText → Authorize 粘贴 token。token 错误会当场被拒绝并给出明确提示，省去了靠后续调用失败反推配置问题的麻烦。

为什么用 API token 而不是账号登录

Apify token 是一串绑定账号的密钥，用于在 api.apify.com 上鉴权并触发 Actor 运行。TubeText 全程只与这个官方 API 通信，不会模拟登录 TikTok、AliExpress 或 YouTube，也就不涉及保存账号密码、处理二次验证或触发平台风控。对数据采集场景来说，这种架构把风险面收敛到了「token 泄露」这一件事上：只要 token 没有外泄，账号本身不会被牵连。反过来也需要注意，token 等于账号的操作凭证，粘贴到 Dify 后应视为敏感信息管理，一旦怀疑泄露，可在 Apify 控制台直接重置，旧 token 立即失效。

实战工作流一：拆解任何视频的钩子

最小可用工作流只有三个节点。Start 接收一个 video_url 输入；TubeText → Video Transcript 把该变量映射到 Links 字段；LLM 节点直接消费工具返回的 text 字段，例如提示词写成「这是一段短视频转录文本，引用开头第一句作为钩子，列出卖点，并给出一个更强的钩子建议」。

工具返回两部分数据：text 是所有转录拼接后的纯文本，可直接喂给 LLM；json 则保留结构化条目、数量以及每次 Apify run 的 ID 和 URL。实测中，一个 YouTube 链接加一个 TikTok 链接的单次调用耗时 26 秒，插件会把链接拆分到 YouTube 和 TikTok 两个 Actor 并行执行。

实战工作流二：按市场做 AliExpress 价格监测

加入 AliExpress Search 节点，指定关键词、收货国家和货币即可。原作者用德国 / 欧元、按订单量排序、取 3 条结果做了测试，每个商品一行，包含该货币价格、销量、评分和发货地。这些数据可以继续流向 LLM 节点生成「价格区间与畅销款」摘要，也可以交给 code 节点筛选低于目标价的产品。

有一个细节对价格研究很关键：AliExpress 会展示大量新用户专享折扣，普通买家实际拿不到。该工具会标记这类折扣和赞助结果，并支持跳过，避免研究者把虚高优惠当成市场价。

在 Agent 应用中的使用方式

在 agent 应用中启用 TubeText 的工具后，每个工具自带描述，帮助模型判断何时调用。作者列出的典型提示词包括「获取这个 TikTok 的转录并告诉我钩子是什么：[链接]」「在 AliExpress 上找 5 到 20 美元之间的瑜伽垫，按订单量排序」「这个 TikTok Shop 商品卖了多少件，哪个变体库存最多？[链接]」。需要说明的是，作者在自托管 Dify 上只测过工作流模式，agent 模式尚未实际跑模型验证，属于单一来源的经验。

长任务不阻塞工作流

每次调用默认最多等待 240 秒（Max Wait）。如果任务超过这个时限——例如抓取整个 YouTube 频道——任务会继续在 Apify 上运行，工具立刻返回 run ID。之后用 Get Run Results 节点取回数据，支持 offset 和 limit 分页。作者以 3 秒 Max Wait 做验证：工具返回 RUNNING 状态和 run ID，随后 Get Run Results 成功取回完成后的数据。这套异步机制让长任务不会拖住整条工作流。

异步调用的基本模式

网页抓取的耗时高度不确定：一个商品页可能两秒返回，也可能因为重试或人机校验拖到几分钟。如果工作流同步等待，整条链路会被单个慢任务卡住，甚至触发 Dify 的超时限制。TubeText 采用的模式是「超时即降级为异步」——Max Wait 内完成就当场返回数据，超过则立刻返回一个 run ID 作为凭据，把耗时的部分留在 Apify 云端继续跑。调用方后续凭这个 ID 轮询结果，配合 offset 和 limit 分批取回。这是抓取类集成的通用做法：用一次额外的往返换取工作流的稳定响应时间，代价是需要自己安排「稍后再取」这一步。

成本结构

插件免费开源，费用按结果计费，走你自己的 Apify 账号（以下为 Apify 免费计划价格）：

• YouTube 转录 $4 / 千条，TikTok 转录 $3 / 千条，AI 转录 $0.006 / 分钟且仅在手动开启时计费
• TikTok Shop：$4 / 千个含完整详情的商品
• AliExpress：$2.50 / 千个商品

失败条目不计费，已下架商品和纯音乐 TikTok 同样不计费。Apify 免费计划自带月度额度，作者整轮四工具测试的总花费约为 $0.007。

需要提前了解的边界

使用前有三个限制值得注意：TikTok Shop 只接受链接或商品 ID，不支持关键词搜索，且仅覆盖美国站；AliExpress 返回的是搜索结果数据，不含商品详情页信息或店铺名称；插件只与 Apify API 通信，不涉及任何平台账号登录。

源码与问题反馈入口在 github.com/LMSlay/dify-plugin-tubetext。对于想在 Dify 工作流里加入真实电商数据和视频内容的开发者，这是一个配置门槛低、按量付费的补充方案。