> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 怎样从小红书找到品牌相关的问题反馈，并交给负责人跟进？

> 按品牌与具体经历搜索，核对笔记和评论上下文，整理产品、物流、服务线索及下一步，复用已保存材料控制查询量。

要从小红书找到品牌问题，用 `data:xiaohongshu.app_v2.search_notes` 搜“品牌或型号＋具体经历”，读相关笔记的评论，再把原句、来源和下一步整理给负责人。比如咖啡机品牌可以从“机型＋漏水”“机型＋清洗”“品牌＋客服”开始，比只搜一个品牌名更容易定位需要处理的讨论。

最终交付一份经过核对的反馈线索表，每条线索写明：是否与本品牌有关、涉及产品还是服务、还缺什么信息、下一步由谁核查。先完成一轮发现和交接，再按实际需要安排持续更新。

## 1. 搜具体经历，先判断品牌相关性

调用 `data:xiaohongshu.app_v2.search_notes`，把 `sort_type` 设为 `time_descending` 取最新笔记，即 `sort_type:time_descending`。按[笔记搜索流程](/zh/guides/xiaohongshu-notes-research)保存结果，逐篇核对型号、上下文和来源；多个词命中同一篇笔记时，沿用同一条笔记记录。

给已接入 BeatAPI 工具的助手布置任务时，可以这样写：

> 搜这个品牌和机型近期的使用反馈，先看3组具体问题词。只选实际涉及该品牌的笔记，保留来源和入选理由；再读选中评论，按产品、物流、服务整理原句与下一步。

第一批关键词按真实使用环节来写，看过返回材料后再调整。搜索摘要足以筛候选时，先用摘要选笔记；要判断一项经历，再补取笔记详情或讨论上下文。

## 2. 从评论保留可核查的原话

按[评论与回复指南](/zh/guides/xiaohongshu-note-comments)保存选中笔记的评论，再在本地提取：

```bash
python3 comment_research.py extract comment-pages.json comment-review
```

把每篇笔记和笔记下的评论放在一起读：有人描述收到包裹损坏，有人询问清洁方法，也可能有回复说明问题已经处理。三种情况分别记录，不把一句“避雷”自动当成已确认事件。

保留完整的 `comment-review` 目录。要修改分类时，用已存的原始响应在本地重新导出，不必再次查询。

## 3. 按相关性、问题类型和下一步审核

把下方 Python 脚本保存为 `complaint_queue.py`，先运行 `complaint_queue.py prepare` 生成审核模板 `complaint-review.json`：

```bash
python3 complaint_queue.py prepare comment-review "示例品牌 / 型号" complaint-review.json
```

逐条看原文，为 `complaint-review.json` 里的每一项填写下列决定之一：

| 决定              | 写什么                                                                         |
| --------------- | --------------------------------------------------------------------------- |
| `relevant`      | 实际原句、品牌关联依据 `brand_context`、product/logistics/service/other 类型、工作优先级、理由及下一步 |
| `unrelated`     | 为什么不是这个品牌或本轮问题，保留排除理由                                                       |
| `needs_context` | 原句、还缺哪段上下文、怎样补查                                                             |

例如“包裹到时配件盒破了”归为物流线索，先由物流负责人核对配送事实，不改写成产品设计结论。配件盒的例子只示范分类写法，引文请使用你实际保存的原句。

审核完成后，运行 `complaint_queue.py finalize`，在 `complaint-queue` 目录生成队列：

```bash
python3 complaint_queue.py finalize comment-review complaint-review.json complaint-queue
```

```python
import csv, hashlib, json, pathlib, sys
mode, directory, argument, output = sys.argv[1:]
root = pathlib.Path(directory)
raw_comments = (root/'comments.json').read_bytes()
integrity_bytes = (root/'integrity.json').read_bytes()
integrity = json.loads(integrity_bytes)
if hashlib.sha256(raw_comments).hexdigest() != integrity['comments_sha256']: raise ValueError('Comment evidence changed')
for filename,key in [('pagination.json','pagination_sha256'),('input-manifest.json','manifest_sha256')]:
    if hashlib.sha256((root/filename).read_bytes()).hexdigest()!=integrity[key]: raise ValueError('Export provenance changed')
for source in integrity['sources']:
    if pathlib.Path(source['file']).name!=source['file']: raise ValueError('Invalid source path')
    if hashlib.sha256((root/source['file']).read_bytes()).hexdigest()!=source['sha256']: raise ValueError('Raw source changed')
records=json.loads(raw_comments);by_id={r['evidence_id']:r for r in records}
if len(by_id)!=len(records): raise ValueError('Duplicate evidence ID')
def write_new(path,value):
    with pathlib.Path(path).open('x',encoding='utf-8') as f:json.dump(value,f,ensure_ascii=False,indent=2)
if mode=='prepare':
    if not argument.strip(): raise ValueError('Name the brand/product in scope')
    items=[{k:r[k] for k in ['evidence_id','note_id','comment_id','source_sha256']} for r in records]
    for item in items:item.update(decision='unreviewed',category='',priority='',quote='',brand_context='',next_step='',reason='')
    write_new(output,{'brand_scope':argument,'comments_sha256':integrity['comments_sha256'],'items':items})
    print(json.dumps({'review_items':len(items),'executed_calls':0}))
elif mode=='finalize':
    review_bytes=pathlib.Path(argument).read_bytes();review=json.loads(review_bytes)
    brand=review.get('brand_scope');items=review.get('items')
    if not isinstance(brand,str) or not brand.strip() or review.get('comments_sha256')!=integrity['comments_sha256']: raise ValueError('Wrong brand scope or evidence export')
    if not isinstance(items,list) or len(items)!=len(records) or {x['evidence_id'] for x in items}!=set(by_id): raise ValueError('Review every evidence row exactly once')
    queue,unrelated,context=[],[],[]
    for item in items:
        r=by_id[item['evidence_id']]
        if any(item.get(k)!=r[k] for k in ['note_id','comment_id','source_sha256']): raise ValueError('Review belongs to another source')
        decision=item.get('decision');reason=item.get('reason')
        if decision not in ('relevant','unrelated','needs_context') or not isinstance(reason,str) or not reason.strip(): raise ValueError('Every decision needs a review reason')
        if decision=='unrelated':
            unrelated.append({'evidence_id':r['evidence_id'],'reason':reason});continue
        quote=item.get('quote');next_step=item.get('next_step')
        if not isinstance(quote,str) or not quote.strip() or len(quote)>500 or quote not in r['text']: raise ValueError('Use an exact short source excerpt')
        if not isinstance(next_step,str) or not next_step.strip(): raise ValueError('Record the next internal verification step')
        if decision=='needs_context':
            context.append({'evidence_id':r['evidence_id'],'note_id':r['note_id'],'comment_id':r['comment_id'],'quote':quote,'reason':reason,'next_step':next_step});continue
        if item.get('category') not in ('product','logistics','service','other') or item.get('priority') not in ('routine','priority'): raise ValueError('Choose category and human-assigned review priority')
        if not isinstance(item.get('brand_context'),str) or not item['brand_context'].strip(): raise ValueError('Explain how you verified brand/product relevance from the source context')
        queue.append({'evidence_id':r['evidence_id'],'note_id':r['note_id'],'comment_id':r['comment_id'],
            'brand_scope':brand,'category':item['category'],'review_priority':item['priority'],
            'quote':quote,'brand_context':item['brand_context'],'review_reason':reason,'next_step':next_step,
            'source_file':r['source_file'],'source_sha256':r['source_sha256'],'request_id':r['request_id'],
            'claim_verified':False,'contacted_anyone':False})
    target=pathlib.Path(output);target.mkdir()
    (target/'review-input.json').write_bytes(review_bytes)
    (target/'integrity.json').write_bytes(integrity_bytes)
    write_new(target/'issue-queue.json',{'brand_scope':brand,'items':queue,'needs_context':context,'unrelated':unrelated,
        'coverage':{'reviewed_comments':len(records),'relevant_signals':len(queue),'unrelated':len(unrelated),'needs_context':len(context),'distinct_notes_with_signals':len({r['note_id'] for r in queue})},
        'review_sha256':hashlib.sha256(review_bytes).hexdigest(),'scope':'Human-reviewed signals in the saved sample, not verified incidents, unique customers or population prevalence','executed_calls':0})
    fields=['evidence_id','note_id','comment_id','brand_scope','category','review_priority','quote','brand_context','review_reason','next_step','source_file','source_sha256','request_id']
    with (target/'issue-queue.csv').open('w',encoding='utf-8-sig',newline='') as f:
        w=csv.DictWriter(f,fieldnames=fields);w.writeheader()
        for row in queue:
            cells={k:str(row[k]) for k in fields};w.writerow({k:"'"+v if v.lstrip().startswith(('=','+','-','@')) else v for k,v in cells.items()})
    print(json.dumps({'signals':len(queue),'needs_context':len(context),'unrelated':len(unrelated),'executed_calls':0}))
else: raise ValueError('Use prepare EXPORT_DIR BRAND OUTPUT_JSON or finalize EXPORT_DIR REVIEW_JSON OUTPUT_DIR')
```

## 4. 交给负责人时，怎样说明？

`issue-queue.csv` 放已确认相关的线索和下一步；`issue-queue.json` 除相关线索外，还保留不相关和待补上下文的记录。保留原始响应与审核记录，负责人可以按来源追问。

审核优先级表示先处理什么，`claim_verified:false` 提醒接收人事实还要核实。同一篇笔记里的重复观察不多算事件；类似提问可以归到同一主题，每条提问的来源笔记和原句分别列明。

例如有人留言「适配器插上就发热」。交给产品支持时，原句和来源照录，状态填「待核」，下一步问适配器型号、使用时间和发热位置。另一条「收到时外箱破了」交给物流，核对包裹和签收情况。周报可以写「两条待核线索已分流」，等产品支持和物流反馈后再更新处理结果。

## 5. 费用与后续复查怎样安排？

搜索页、一级评论页、选中回复页和额外详情分别计请求数，按[价格页](https://beatapi.io/zh/pricing)当前单价估算。第一轮可计划 3 页关键词搜索、2 页选中评论和 1 页回复，最多共 6 页请求；材料不相关时减少后续取数。

需要日常复查时，保存已看笔记的标识和未处理的线索：新笔记进入发现队列，旧问题按处理状态复查。写清每轮的首页观察范围和查询时间；定时运行和提醒由你自己的调度和通知流程安排。

[笔记搜索](/zh/guides/xiaohongshu-notes-research) · [评论研究](/zh/guides/xiaohongshu-note-comments)