name	juejin-publisher
version	2.2.0
license	MIT
description	掘金全栈运营技能。AI文章生成+发布 + 评论区获客(搜索→评分→LLM评论→私信) + 热点自动发文(TrendRadar→LLM改写→API发布) + 热点获客发文(产品软植入)。
metadata	{"openclaw":{"emoji":"⛏️","category":"publishing"},"clawdbot":{"emoji":"⛏️","requires":{"bins":["python3","node","curl"]},"install":[]}}

掘金全栈运营技能 v2.2.0

功能总览

功能	脚本	说明
📝 文章生成+发布	`juejin-article-publisher.py`	LLM生成技术文章 → 人工确认 → API发布
💬 评论区获客	`juejin_acquisition.py`	搜索 → AI四维评分 → LLM评论 → LLM私信
🔥 热点自动发文	`juejin-hotspot-publisher.js`	TrendRadar RSS → AI改写 → Pexels封面 → API发布
🎯 热点获客发文	`juejin-hotspot-acquisition.js`	产品分析 → V2EX热点 → AI结合产品软植入 → API发布
📄 Markdown发布	`publish.py`	Markdown文章一键发布（API方式）
🔍 文章查询	`query_article.py`	查询文章互动数据
🏷️ 标签查询	`query_tags.py`	搜索掘金标签ID

模块一：AI 文章生成+发布

架构

产品链接 → LLM读取网站 → 生成技术文章(标题+正文) 
→ 保存草稿(.md) → 人工确认 → Pexels封面 → API直发发布

快速使用

# 测试模式（只生成文章，不发布）
python3 scripts/juejin-article-publisher.py --product-url "https://ai.hcrzx.com/" --dry-run

# 交互确认发布
python3 scripts/juejin-article-publisher.py --product-url "https://ai.hcrzx.com/"

# 自动发布（非交互）
python3 scripts/juejin-article-publisher.py --product-url "https://ai.hcrzx.com/" --auto-confirm

流程

LLM生成 — 读取产品网站 → 按 templates/article-prompt.md 模板生成
保存草稿 — 草稿保存到 data/juejin_draft_*.md
人工确认 — 交互式确认（y/n），支持 --auto-confirm 跳过
封面图片 — Pexels自动搜索 → 下载到 ~/juejin_cover_images/
BW发布 — 调用BrowserWing脚本发布到掘金编辑器

前置条件

掘金 Cookie: 需要在 juejin.env 文件中配置有效的掘金登录 Cookie
Pexels API Key: 封面图片使用 Pexels API（已内置）

模块二：评论区获客 v2.0

架构

产品链接 → LLM生成关键词(6个) → 搜索掘金文章 
→ AI四维评分(热度40+互动30+时效20+质量10) 
→ 筛选Top10 → LLM逐篇生成评论(4种风格) → 自动发表
→ LLM生成私信 → 自动发送

快速使用

# 全自动获客
python3 scripts/juejin_acquisition.py auto --product-url "https://ai.hcrzx.com/"

# 测试模式（不真实发表）
python3 scripts/juejin_acquisition.py auto --product-url "https://ai.hcrzx.com/" --dry-run

# 控制数量
python3 scripts/juejin_acquisition.py auto \
  --product-url "https://ai.hcrzx.com/" \
  --max-comments 5 \
  --max-messages 2

# 单独搜索
python3 scripts/juejin_acquisition.py search --keyword "AI大模型"

AI 能力

能力	实现
关键词生成	LLM从产品链接动态生成6个搜索词 + 种子池降级
四维评分	热度(40) + 互动(30) + 时效(20) + 质量(10)
评论生成	LLM读完整文章 → 4种风格随机(赞同补充/提问讨论/实战分享/案例分析)
私信生成	LLM读文章后生成真诚交流私信
反爬保护	时段8-23 + 日/小时上限 + 加权随机延迟 + 历史去重

评论API关键点

端点: POST /interact_api/v1/comment/publish
基础URL: https://juejin.cn（不可用 api.juejin.cn，会返回空响应）
字段名: comment_content（不是 content）
请求体: {"item_id": "...", "item_type": 2, "comment_content": "..."}

📚 常用分类/标签 ID

分类	category_id
前端	`6809637767543259144`
后端	`6809637769959178254`
AI	`6809637773935378440`
工具	`6809637771511070734`

标签	tag_id
AI	`6809640445233070096`
Python	`6809640408797167623`
JavaScript	`6809640407484334093`
自动化	`6809637772874219534`

模块三：热点自动发文 (v1.0.0)

架构

定时/手动触发
    ↓
步骤1: TrendRadar MCP HTTP 获取新智元 RSS (20条)
    ↓
步骤2: Baidu Qianfan LLM 挑选最值得写的 + 逐篇改写
    ├── 挑选: 技术深度 > 商业价值 > 话题热度
    └── 改写: 掘金技术文章风格, 1500-3500字
    ↓
步骤3: Pexels 生成封面 (AI→technology 兜底)
    ↓
步骤4: 保存 .md → 调用 publish.py → Juejin API 发布
    ↓
发布记录: output/YYYY-MM-DD/publish-record.json

快速使用

cd ~/.openclaw/workspace/skills/juejin-publisher

# 全自动模式 (V2EX优先→降级新智元)
node scripts/juejin-hotspot-publisher.js --auto

# 测试模式 (不实际发布)
node scripts/juejin-hotspot-publisher.js --dry-run --max 1

# 强制使用 V2EX
node scripts/juejin-hotspot-publisher.js --auto --source v2ex

# 强制使用新智元RSS
node scripts/juejin-hotspot-publisher.js --auto --source xinzhiyuan

# 指定代理地址
node scripts/juejin-hotspot-publisher.js --auto --proxy http://127.0.0.1:7890

数据源策略

优先级	渠道	获取方式
1	新智元 RSS	TrendRadar RSS → 筛选 xinzhiyuan 源
2	V2EX	TrendRadar 热榜（降级备用）

新智元 RSS 每天推送 AI/科技领域深度文章，天然适合技术与 AI 产品结合
RSS 不可用时自动降级到 V2EX 热榜
同日 URL 去重，避免重复发布

模块四：热点获客发文 (v1.0.0)

架构

产品链接 → LLM分析产品(卖点/用户/功能)
    ↓
TrendRadar V2EX 热点 (120条) → AI挑选最相关 Top N
    ↓
LLM 结合热点+产品生成获客文章
  ├── 从热点话题切入（行业痛点/技术趋势）
  ├── 自然地引出产品（分享真实体验）
  └── 正文嵌入产品链接，引导点击
    ↓
Pexels 封面 → 保存 .md → 调用 publish.py → Juejin API 发布

与热点自动发文的区别

维度	热点自动发文	热点获客发文
目标	纯内容产出	内容+获客
输入	无	`--product-url` 必填
文章风格	技术资讯改写	热点切入+产品软植入
产品链接	无	正文自然嵌入
挑选标准	技术深度/热度	与产品相关性+获客潜力

快速使用

cd ~/.openclaw/workspace/skills/juejin-publisher

# 全自动模式（分析产品 → 获取热点 → 生成文章 → 发布）
node scripts/juejin-hotspot-acquisition.js --product-url "https://ai.hcrzx.com"

# 测试模式（不实际发布）
node scripts/juejin-hotspot-acquisition.js --product-url "https://ai.hcrzx.com" --dry-run --max 1

# 指定代理
node scripts/juejin-hotspot-acquisition.js --product-url "https://ai.hcrzx.com" --proxy http://127.0.0.1:7890

🛠️ 故障排查

现象	原因	解决方案
评论返回空body	api.juejin.cn域名	改用 juejin.cn 代理
评论err_no=4005	字段名错误	用 `comment_content` 不用 `content`
评论err_no=1	Cookie失效	重新登录掘金获取Cookie
搜索返回空	搜索API不需要auth	检查关键词和网络
LLM不可用	zhihu_llm.py未找到	检查模块搜索路径
TrendRadar连不上	MCP Server未启动	检查 `100.111.235.91:3333` 可达性
热点发文LLM失败	BAIDU_API_KEY未设	设置千帆API Key或切换 provider
热点获客无产品分析	产品页面抓取失败	检查产品链接可访问性，或手动填入产品信息

name	juejin-publisher
version	2.2.0
license	MIT
description	掘金全栈运营技能。AI文章生成+发布 + 评论区获客(搜索→评分→LLM评论→私信) + 热点自动发文(TrendRadar→LLM改写→API发布) + 热点获客发文(产品软植入)。
metadata	{"openclaw":{"emoji":"⛏️","category":"publishing"},"clawdbot":{"emoji":"⛏️","requires":{"bins":["python3","node","curl"]},"install":[]}}

掘金全栈运营技能 v2.2.0

功能总览

功能	脚本	说明
📝 文章生成+发布	`juejin-article-publisher.py`	LLM生成技术文章 → 人工确认 → API发布
💬 评论区获客	`juejin_acquisition.py`	搜索 → AI四维评分 → LLM评论 → LLM私信
🔥 热点自动发文	`juejin-hotspot-publisher.js`	TrendRadar RSS → AI改写 → Pexels封面 → API发布
🎯 热点获客发文	`juejin-hotspot-acquisition.js`	产品分析 → V2EX热点 → AI结合产品软植入 → API发布
📄 Markdown发布	`publish.py`	Markdown文章一键发布（API方式）
🔍 文章查询	`query_article.py`	查询文章互动数据
🏷️ 标签查询	`query_tags.py`	搜索掘金标签ID

模块一：AI 文章生成+发布

架构

产品链接 → LLM读取网站 → 生成技术文章(标题+正文) 
→ 保存草稿(.md) → 人工确认 → Pexels封面 → API直发发布

快速使用

# 测试模式（只生成文章，不发布）
python3 scripts/juejin-article-publisher.py --product-url "https://ai.hcrzx.com/" --dry-run

# 交互确认发布
python3 scripts/juejin-article-publisher.py --product-url "https://ai.hcrzx.com/"

# 自动发布（非交互）
python3 scripts/juejin-article-publisher.py --product-url "https://ai.hcrzx.com/" --auto-confirm

流程

LLM生成 — 读取产品网站 → 按 templates/article-prompt.md 模板生成
保存草稿 — 草稿保存到 data/juejin_draft_*.md
人工确认 — 交互式确认（y/n），支持 --auto-confirm 跳过
封面图片 — Pexels自动搜索 → 下载到 ~/juejin_cover_images/
BW发布 — 调用BrowserWing脚本发布到掘金编辑器

前置条件

掘金 Cookie: 需要在 juejin.env 文件中配置有效的掘金登录 Cookie
Pexels API Key: 封面图片使用 Pexels API（已内置）

模块二：评论区获客 v2.0

架构

产品链接 → LLM生成关键词(6个) → 搜索掘金文章 
→ AI四维评分(热度40+互动30+时效20+质量10) 
→ 筛选Top10 → LLM逐篇生成评论(4种风格) → 自动发表
→ LLM生成私信 → 自动发送

快速使用

# 全自动获客
python3 scripts/juejin_acquisition.py auto --product-url "https://ai.hcrzx.com/"

# 测试模式（不真实发表）
python3 scripts/juejin_acquisition.py auto --product-url "https://ai.hcrzx.com/" --dry-run

# 控制数量
python3 scripts/juejin_acquisition.py auto \
  --product-url "https://ai.hcrzx.com/" \
  --max-comments 5 \
  --max-messages 2

# 单独搜索
python3 scripts/juejin_acquisition.py search --keyword "AI大模型"

AI 能力

能力	实现
关键词生成	LLM从产品链接动态生成6个搜索词 + 种子池降级
四维评分	热度(40) + 互动(30) + 时效(20) + 质量(10)
评论生成	LLM读完整文章 → 4种风格随机(赞同补充/提问讨论/实战分享/案例分析)
私信生成	LLM读文章后生成真诚交流私信
反爬保护	时段8-23 + 日/小时上限 + 加权随机延迟 + 历史去重

评论API关键点

端点: POST /interact_api/v1/comment/publish
基础URL: https://juejin.cn（不可用 api.juejin.cn，会返回空响应）
字段名: comment_content（不是 content）
请求体: {"item_id": "...", "item_type": 2, "comment_content": "..."}

📚 常用分类/标签 ID

分类	category_id
前端	`6809637767543259144`
后端	`6809637769959178254`
AI	`6809637773935378440`
工具	`6809637771511070734`

标签	tag_id
AI	`6809640445233070096`
Python	`6809640408797167623`
JavaScript	`6809640407484334093`
自动化	`6809637772874219534`

模块三：热点自动发文 (v1.0.0)

架构

定时/手动触发
    ↓
步骤1: TrendRadar MCP HTTP 获取新智元 RSS (20条)
    ↓
步骤2: Baidu Qianfan LLM 挑选最值得写的 + 逐篇改写
    ├── 挑选: 技术深度 > 商业价值 > 话题热度
    └── 改写: 掘金技术文章风格, 1500-3500字
    ↓
步骤3: Pexels 生成封面 (AI→technology 兜底)
    ↓
步骤4: 保存 .md → 调用 publish.py → Juejin API 发布
    ↓
发布记录: output/YYYY-MM-DD/publish-record.json

快速使用

cd ~/.openclaw/workspace/skills/juejin-publisher

# 全自动模式 (V2EX优先→降级新智元)
node scripts/juejin-hotspot-publisher.js --auto

# 测试模式 (不实际发布)
node scripts/juejin-hotspot-publisher.js --dry-run --max 1

# 强制使用 V2EX
node scripts/juejin-hotspot-publisher.js --auto --source v2ex

# 强制使用新智元RSS
node scripts/juejin-hotspot-publisher.js --auto --source xinzhiyuan

# 指定代理地址
node scripts/juejin-hotspot-publisher.js --auto --proxy http://127.0.0.1:7890

数据源策略

优先级	渠道	获取方式
1	新智元 RSS	TrendRadar RSS → 筛选 xinzhiyuan 源
2	V2EX	TrendRadar 热榜（降级备用）

新智元 RSS 每天推送 AI/科技领域深度文章，天然适合技术与 AI 产品结合
RSS 不可用时自动降级到 V2EX 热榜
同日 URL 去重，避免重复发布

模块四：热点获客发文 (v1.0.0)

架构

产品链接 → LLM分析产品(卖点/用户/功能)
    ↓
TrendRadar V2EX 热点 (120条) → AI挑选最相关 Top N
    ↓
LLM 结合热点+产品生成获客文章
  ├── 从热点话题切入（行业痛点/技术趋势）
  ├── 自然地引出产品（分享真实体验）
  └── 正文嵌入产品链接，引导点击
    ↓
Pexels 封面 → 保存 .md → 调用 publish.py → Juejin API 发布

与热点自动发文的区别

维度	热点自动发文	热点获客发文
目标	纯内容产出	内容+获客
输入	无	`--product-url` 必填
文章风格	技术资讯改写	热点切入+产品软植入
产品链接	无	正文自然嵌入
挑选标准	技术深度/热度	与产品相关性+获客潜力

快速使用

cd ~/.openclaw/workspace/skills/juejin-publisher

# 全自动模式（分析产品 → 获取热点 → 生成文章 → 发布）
node scripts/juejin-hotspot-acquisition.js --product-url "https://ai.hcrzx.com"

# 测试模式（不实际发布）
node scripts/juejin-hotspot-acquisition.js --product-url "https://ai.hcrzx.com" --dry-run --max 1

# 指定代理
node scripts/juejin-hotspot-acquisition.js --product-url "https://ai.hcrzx.com" --proxy http://127.0.0.1:7890

🛠️ 故障排查

现象	原因	解决方案
评论返回空body	api.juejin.cn域名	改用 juejin.cn 代理
评论err_no=4005	字段名错误	用 `comment_content` 不用 `content`
评论err_no=1	Cookie失效	重新登录掘金获取Cookie
搜索返回空	搜索API不需要auth	检查关键词和网络
LLM不可用	zhihu_llm.py未找到	检查模块搜索路径
TrendRadar连不上	MCP Server未启动	检查 `100.111.235.91:3333` 可达性
热点发文LLM失败	BAIDU_API_KEY未设	设置千帆API Key或切换 provider
热点获客无产品分析	产品页面抓取失败	检查产品链接可访问性，或手动填入产品信息