Agent Skills
返回列表
QINLU.AI 灵犀数据下载

QINLU.AI 灵犀数据下载

数据分析 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-r7s4nepo/qinlu-ai-data。

技能介绍

要解决什么问题

做小红书品牌或品类经营分析时,灵犀后台的数据往往只能在线看、按导出规则零散下载,很难把指定品牌 / 品类 / SPU在一段日期内的结果稳定落到本地,并按日期归档给下游脚本或 BI 用。手工登录、选类目、等任务、解压归档也容易在鉴权过期、类目 code 填错、任务未结束时反复踩坑。

技能如何工作

技能把流程拆成三类 CLI:lingxi-account.js 负责灵犀品牌绑定(bind 开浏览器登录,最长阻塞约 5 分钟)、qinlu-account.js 负责平台 apiKey(configure),lingxi-download.js 负责创建任务、轮询、按日期下载(create → poll → download)。

配置以 JSON 为唯一入口(--config-file),dates 与 selection.namespaces 必填;品类模块要求 category 为从 categories 命令拿到的 [{code,name}],SPU 模块需要真实 SPU 名。create 会先做自检,通过后才提交云端;产物解压后写入 data-source/lingxi/data/{品牌}/{日期}/...(v1.7.0 起不在本地保留原始 zip)。

脚本约定:完成与否只看 stdout 末行 __RESULT__,stderr 心跳不代表退出。遇错时 __RESULT__ 带 error/remedy,例如鉴权失败走 configure,未绑定品牌走 bind,类目格式问题应重跑 categories 取真实 code。

适用边界与注意点

  • 依赖浏览器登录灵犀与(必要时)设备码授权,Agent 侧应预留足够等待时间(bind 至少按 5 分钟、poll 默认可达 600 秒量级考虑)。
  • 云端任务与数据以平台为准;本地已有同日期会覆盖合并,要全量重下应重跑 download 子命令。
  • intent 字段可透传但云端当前不消费,仅保留接口;选 namespace 与字段含义应先对照技能内的 data-map 文档再建任务。

使用场景

  • 竞品分析同学要拉某品牌两周灵犀报表,按天落到本地目录给 Python 做趋势对比
  • 品类运营在配置里填真实类目 code,创建云端任务后轮询到 done 再批量 download
  • SPU 上新复盘需要从灵犀列出真实 SPU 名,选定后在 config 里跑 create 与归档
  • cookie 过期导致 unauthorized 时,按 __RESULT__ 的 remedy 先 configure 再 bind 后继续采集

适合人员

  • 负责小红书投放与品牌屏效的数据分析师,要把灵犀导出变成可脚本化的按日数据集
  • 做多品牌代运营的策略同学,需要为每个绑定品牌反复跑 categories/spus 校验后再建采集任务
  • 把灵犀原始表接入内部数仓的工程师,关心产物路径与 namespace 字段是否与 data-map 一致
  • 用 AI 助手代跑采集流程的运营,需要理解 bind/poll 阻塞与 __RESULT__ 完成信号避免误判超时