QINLU.AI 灵犀数据下载
将以下提示词粘贴到你的 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__ 完成信号避免误判超时