# 2-taobao-query-skills

一个基于用户提供基础 Cookie 的闲鱼关键词查询 CLI。

## 功能说明

- 支持导入用户从闲鱼网页拿到的基础 Cookie
- 自动把可用会话保存到 `session.json`
- 自动通过 `mtop.gaia.nodejs.gaia.idle.data.gw.v2.index.get` 补齐 `_m_h5_tk / _m_h5_tk_enc`
- 在查询时直接用 Node 请求闲鱼搜索接口，不依赖浏览器自动化
- 支持 `login / query / export / logout`
- 支持单关键词、多关键词、完整结果和 CSV / JSON 导出

## 安装

本地开发直接运行：

```bash
node ./bin/2-taobao-query-skills.cjs --help
```

发布到 npm 后可以直接使用：

```bash
npm install -g xianyu-query
xianyu-query --help
```

## 发布前建议

先本地执行：

```bash
npm test
```

然后按常规 npm 流程发布：

```bash
npm version patch
npm publish
```

如果只是本地调试 CLI：

```bash
npm run cli -- --help
```

## 命令列表

```bash
xianyu-query login --cookie '<cookie>' [--session session.json] [--query codex] [--raw] [--json]
xianyu-query query [--cookie '<cookie>'] [--session session.json] [--full] [--raw] [--csv|--json|--pretty] <关键词...>
xianyu-query export [--cookie '<cookie>'] [--session session.json] --output results.csv [--full] [--raw] [--csv|--json|--pretty] <关键词...>
xianyu-query logout [--session session.json]
xianyu-query <关键词...>
```

## 首次初始化会话

如果本地还没有可用会话，先在浏览器打开：

```text
https://www.goofish.com/search?q=codex&spm=a21ybx.search.searchInput.0
```

然后把页面里的基础 Cookie 传给 CLI。这里不要求你手工带上 `_m_h5_tk / _m_h5_tk_enc`，CLI 会在首次请求时自动补齐：

```bash
xianyu-query login \
  --cookie '<document.cookie 或请求头 cookie>' \
  --query codex
```

执行成功后，会自动生成并刷新本地 `session.json`。默认只输出：

```text
登录成功
```

后续查询一般不需要再次提供 Cookie。

## 基础 Cookie 说明

通常下面这些基础字段已经足够完成自举：

- `cookie2`
- `cna`
- `t`
- `_tb_token_`
- `tfstk`

其他账号态字段如果有，也建议一并传入。

不需要你手动准备：

- `_m_h5_tk`
- `_m_h5_tk_enc`
- `mtop_partitioned_detect`

这些会由脚本在首次 bootstrap 时自动拿到并写入本地会话。

## 常用用法

单关键词查询：

```bash
xianyu-query codex
```

或者显式写法：

```bash
xianyu-query query codex
```

多关键词查询：

```bash
xianyu-query query \
  小红薯 business 酒店
```

输出第一页全部结果：

```bash
xianyu-query query --full \
  codex
```

把结果写入文件：

```bash
xianyu-query export \
  --full --output results.csv \
  小红薯 business 酒店
```

使用单独的会话文件：

```bash
xianyu-query query \
  --session /tmp/2taobaoquery-session.json \
  codex
```

退出并删除本地会话：

```bash
xianyu-query logout --session /tmp/2taobaoquery-session.json
```

## 返回内容

默认输出为 CSV 文本，更适合终端直接查看。列包括：

- `query`
- `pageNumber`
- `status`
- `numFound`
- `searchId`
- `rn`
- `itemCount`
- `itemId`
- `categoryId`
- `price`
- `area`
- `title`
- `url`
- `failure`

使用 `--full` 后，会输出当前第一页的全部 30 条商品；不加时默认输出前 5 条。

如果你要给脚本或其他程序消费输出，可以加：

```bash
xianyu-query query --json codex
```

其中：

- `--csv`：CSV 文本，适合终端直接读，默认值
- `--json`：单行 JSON，适合脚本读取
- `--pretty`：格式化 JSON，适合人工排查

## 注意事项

- 默认会话文件是仓库根目录下的 `session.json`
- 如果返回 `RGV587_ERROR::SM`，说明当前基础会话被风控拦截，需要重新导入新的浏览器 Cookie
- 当前脚本只抓每个关键词的第一页结果，不自动翻页