SuperAPI AI 工具集

citilink-connector

数据与分析

查看项目

更新于 10-16 09:44

技能介绍

Citilink Connector 用于读取 Citilink 电子商品数据,在操作者自己的 Chrome 中通过 CDP 运行。Citilink 整个域名对非真实浏览器返回 HTTP 429,且其数据通道使用 gRPC-web(二进制 protobuf),因此该连接器不走逆向接口,而是借助真实 Chrome 通过 Qrator 并渲染页面后读取 DOM。

用途与触发场景:需要 Citilink 电子商品数据时使用——按文本搜索,或读取某个商品卡片的价格、原价和库存。触发词包括「ситилинк」「citilink」「ситилинк цена」。

主要工具:citilink_search(query) 从渲染后的搜索页返回商品瓦片;citilink_card(product_url) 返回单个卡片,商品 URL 形如 /product/<slug>/,slug 以数字 id 结尾,例如 /product/noutbuk-lenovo-2169270/。另有一个 CLI 专用的三态金丝雀检查 citilink_selfcheck(),并非 MCP 工具,marketplace-mcp doctor 会一次性运行所有连接器的金丝雀。

数据提取方式:Citilink 的 class 名带构建哈希且每次部署都会变化,不能作为选择器;网站为其自身分析发布了稳定的 data-meta-* 约定,提取器以此为键。data-meta-name="Snippet__title" 对应商品名锚点,Snippet__price 对应当前价格(货币符号在子 span 中),Snippet__old-price 对应划线价且不含符号,data-meta-price="59990" 为机器可读的精确金额。优先使用 data-meta-price,因为它无需解析也不会与分期或角标混淆,展示字符串作为回退。

限制与注意事项:若价格开始返回 null,应先检查这些属性是否仍存在——class 名变化属预期且无害,data-meta-* 变化才是真正的漂移。瓦片中除价格外还有其他数字(如折扣角标 -10%、配送点数、预计配送时间、评分与评价数),只有与货币符号关联的数字才视为价格;瓦片中第一个商品锚点是空覆盖链接,标题取自 Snippet__title 锚点。金丝雀通过仅证明页面已渲染且提取器返回了结构,并不证明数字正确,需在同一 Chrome 中打开商品页比对。从数据中心地址访问该域名会返回 429,无法验证,因此该连接器仅在操作者本机有意义。缺失价格一律为 null 而非 0,应视为无数据。

DSH 激活:在 DeepSeek Harness 中,默认配置仅通过廉价 compare 挂载暴露 compare_prices 与 compare_sources;各市场工具与 marketplace_sources 需要设置 RU_MARKETPLACE_MCP_FULL=1 并重启配置后使用,不要在默认模式下调用。