跳到导航

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

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

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

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

调用 data:xiaohongshu.app_v2.search_notes,把 sort_type 设为 time_descending 取最新笔记,即 sort_type:time_descending。按笔记搜索流程保存结果,逐篇核对型号、上下文和来源;多个词命中同一篇笔记时,沿用同一条笔记记录。

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

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

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

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

按评论与回复指南保存选中笔记的评论,再在本地提取:

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

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

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

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

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

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 目录生成队列:

python3 complaint_queue.py finalize comment-review complaint-review.json complaint-queue
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. 费用与后续复查怎样安排?

搜索页、一级评论页、选中回复页和额外详情分别计请求数,按价格页当前单价估算。第一轮可计划 3 页关键词搜索、2 页选中评论和 1 页回复,最多共 6 页请求;材料不相关时减少后续取数。

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

笔记搜索 · 评论研究