wuling-overseas-dealer-expansion-skill/scripts/social/README.md

Facebook Follow + Messenger 建联脚本

本目录是模块二的正式实现：从建联表生成英文社交建联预览，并通过 AdsPower + Playwright 执行 Facebook Page Follow + Messenger 私信。

脚本清单

脚本	作用	默认是否真实发送	默认是否写表
prepare_facebook_outreach.py	读取 Facebook Sheet，按客户类型生成中文判断 + 英文加好友/私信话术 JSON 预览	否	否
send_facebook_outreach.py	根据预览执行 Page Follow + Messenger DM；默认 dry-run，真实执行需 --confirm	否	否
run_facebook_follow_dm.py	模块二总控入口：先生成预览，再调用执行脚本 dry-run 或确认发送	否	否

推荐流程

1. 已在 AdsPower 指纹浏览器中登录 Facebook。
2. 运行总控脚本生成预览，确认客户和英文话术。
3. 运行 dry-run，检查脚本识别到的 Page 顶部 Follow / Message 和 Messenger 目标。
4. 用户明确确认后，加 --confirm-send 真实执行。
5. 只有需要回写建联表时，额外加 --write-workbook。

只生成预览

python scripts/social/run_facebook_follow_dm.py `
  --excel "D:\WEFANBOT\摩洛哥客户建联表-按渠道分类 .xlsx" `
  --sheet Facebook `
  --profile-id k1eu4lc2 `
  --max-contacts 5 `
  --review-only

Dry-run，不真实点击

python scripts/social/run_facebook_follow_dm.py `
  --excel "D:\WEFANBOT\摩洛哥客户建联表-按渠道分类 .xlsx" `
  --sheet Facebook `
  --profile-id k1eu4lc2 `
  --max-contacts 5 `
  --use-open-page

真实执行，仍逐条确认

python scripts/social/run_facebook_follow_dm.py `
  --excel "D:\WEFANBOT\摩洛哥客户建联表-按渠道分类 .xlsx" `
  --sheet Facebook `
  --profile-id k1eu4lc2 `
  --max-contacts 5 `
  --use-open-page `
  --confirm-send

整批已确认后自动逐条执行

python scripts/social/run_facebook_follow_dm.py `
  --excel "D:\WEFANBOT\摩洛哥客户建联表-按渠道分类 .xlsx" `
  --sheet Facebook `
  --profile-id k1eu4lc2 `
  --max-contacts 5 `
  --use-open-page `
  --confirm-send `
  --batch-confirmed

安全规则

• Facebook 对外发送语言固定为英文。
• 默认不写建联表；需要写表时显式加 --write-workbook。
• 默认且强制保持 AdsPower 浏览器打开；不再支持断开 Playwright 连接，浏览器保持打开。
• 私信只能发到 Messenger 小窗或 Messenger 私信页，且必须验证目标客户名称。
• 禁止向帖子评论框、回复框、页面底部通用输入框发送。
• 若主页 發送訊息 按钮不弹出 Messenger 小窗，脚本会兜底打开 https://www.facebook.com/messages/t/<page_slug>，验证客户名称后再发送。
• 遇到验证、限流、异常活动提示时立即停止。