GitHunt
AV

ava-agent/promotion-agent

📣 Social Media Promotion Guide — Curated tools & workflows for cross-posting to 11+ platforms (Juejin, CSDN, Zhihu, Reddit, Twitter, LinkedIn, Dev.to, Product Hunt & more)

automationawesome-listcross-postingdeveloper-toolsguidemarketingpromotionpythonsocial-media

promotion-agent

Claude Code Plugin for multi-platform content publishing via MCP.

Supports 22 platforms: 知乎 · 掘金 · CSDN · 小红书 · 微信公众号 · 微博 · V2EX · SegmentFault · OSCHINA · 博客园 · X/Twitter · Medium · Hashnode · Dev.to · Reddit · LinkedIn · Product Hunt · Hacker News · MoltBook + AI Directories (TAAFT · Futurepedia · Toolify)

Installation

# Clone to Claude Code plugins directory
git clone https://github.com/ava-agent/promotion-agent ~/.claude/plugins/promotion-agent

# Install Python dependencies
cd ~/.claude/plugins/promotion-agent
pip install -e .

Restart Claude Code after installation. The plugin loads automatically via plugin.json.

Configuration

cd ~/.claude/plugins/promotion-agent
cp .env.example .env
# Fill in your platform credentials (see guides below)

Platform Status

Platform Auth Type Method Stability
知乎 Cookie API Stable
掘金 Cookie API (draft + manual publish fallback) Good
CSDN Cookie API (WAF may block, manual fallback) Limited
小红书 QR Login External MCP proxy Stable
微信公众号 AppID/Secret External MCP proxy Stable
微博 OAuth 2.0 API Stable
V2EX Token API Stable
SegmentFault Cookie API Stable
OSCHINA Cookie API Stable
博客园 API Token MetaWeblog XML-RPC Stable
X/Twitter OAuth 1.0a API (tweepy) Stable
Medium Integration Token REST API v1 Stable
Hashnode PAT GraphQL Stable
Dev.to API Key REST API Stable
Reddit OAuth 2.0 API (praw) Stable
LinkedIn OAuth 2.0 REST API Stable
Product Hunt Bearer Token GraphQL Stable
Hacker News Username/Password Web form scraping Fragile
MoltBook API Key API Stable
TAAFT None Form submission Best-effort
Futurepedia None Form submission Best-effort
Toolify None Form submission Best-effort

Credential Setup

These platforms use browser Cookie authentication.

Auto-extract (recommended):

# Ensure you're logged in to the platform in Chrome
python3 get_cookies.py

Manual extract:

  1. Log in to the platform in your browser
  2. F12 → Network tab → refresh → click any request
  3. Copy the Cookie header value
PROMOTE_ZHIHU_COOKIE=_xsrf=xxx; z_c0=xxx; ...
PROMOTE_JUEJIN_COOKIE=sessionid=xxx; ...
PROMOTE_CSDN_COOKIE=UserName=xxx; uuid=xxx; ...
PROMOTE_SEGMENTFAULT_COOKIE=...
PROMOTE_OSCHINA_COOKIE=...

Cookies expire every 1-3 months. Re-extract when auth errors occur.

X / Twitter

  1. Visit developer.x.com, create Project + App
  2. Enable OAuth 1.0a with Read and Write permissions
  3. Generate Access Token & Secret
PROMOTE_X_CONSUMER_KEY=your_consumer_key
PROMOTE_X_CONSUMER_SECRET=your_consumer_secret
PROMOTE_X_ACCESS_TOKEN=your_access_token
PROMOTE_X_ACCESS_TOKEN_SECRET=your_access_token_secret

Medium

  1. Visit medium.com/me/settings/security
  2. Generate an Integration Token
PROMOTE_MEDIUM_INTEGRATION_TOKEN=your_token

Hashnode

  1. Visit hashnode.com/settings/developer
  2. Generate a Personal Access Token
PROMOTE_HASHNODE_TOKEN=your_token
PROMOTE_HASHNODE_PUBLICATION_ID=your_pub_id  # Optional, auto-discovered if omitted

Dev.to

  1. Visit dev.to/settings/extensions
  2. Generate a DEV Community API Key
PROMOTE_DEVTO_API_KEY=your_api_key

LinkedIn

  1. Visit linkedin.com/developers, create an App
  2. Request Share on LinkedIn permission
  3. Obtain an OAuth 2.0 Access Token (scope: w_member_social)
PROMOTE_LINKEDIN_ACCESS_TOKEN=your_access_token

Token expires in 60 days. Re-obtain when expired.

Product Hunt

  1. Visit Product Hunt API Dashboard
  2. Create application, get API Token
PROMOTE_PRODUCTHUNT_TOKEN=your_token

Reddit

  1. Visit reddit.com/prefs/apps
  2. Create a script type app (redirect: http://localhost:8080)
PROMOTE_REDDIT_CLIENT_ID=your_client_id
PROMOTE_REDDIT_CLIENT_SECRET=your_client_secret
PROMOTE_REDDIT_USERNAME=your_username
PROMOTE_REDDIT_PASSWORD=your_password

博客园 (CNBlogs)

  1. Visit cnblogs.com settings
  2. Enable MetaWeblog access and generate API Token
PROMOTE_CNBLOGS_BLOG_URL=https://www.cnblogs.com/your-blog-name
PROMOTE_CNBLOGS_USERNAME=your_username
PROMOTE_CNBLOGS_TOKEN=your_api_token

Hacker News

PROMOTE_HN_USERNAME=your_username
PROMOTE_HN_PASSWORD=your_password

Uses web form scraping (no official API). May break if HN changes its HTML.

MoltBook

PROMOTE_MOLTBOOK_API_KEY=your_api_key

微博 (Weibo)

Requires a Weibo Open Platform app (needs approval).

PROMOTE_WEIBO_ACCESS_TOKEN=your_access_token

Token expires in ~30 days.

V2EX

  1. Visit v2ex.com/settings/tokens
  2. Generate a Personal Access Token
PROMOTE_V2EX_TOKEN=your_token

微信公众号 (WeChat)

PROMOTE_WECHAT_APP_ID=your_app_id
PROMOTE_WECHAT_APP_SECRET=your_app_secret

小红书 (Xiaohongshu)

Auth managed by external MCP proxy. Use auth_qr_login tool to scan QR code.

AI Directories (TAAFT / Futurepedia / Toolify)

No authentication required. Submissions are HTTP form posts.

Architecture

This project is a Claude Code Plugin embedding an MCP Server.

promotion-agent Architecture

Layer Component Purpose
Interaction Skills (/publish) Guide user through publish flow: select platforms, preview, confirm, publish
Automation Agents (publisher) Read content files, split by platform, batch publish, report results
Security Hooks (auth-check) PreToolUse intercept on all publish* calls — validate auth before publishing
Execution MCP Server (server.py) 12 tools, launched as subprocess via plugin.json
Platform Platform classes Each platform implements adapt_content() + post() + health_check()

MCP Tools Reference

Publish Tools (6)

Tool Description Key Parameters
publish_zhihu Publish to Zhihu column title, body, column?, topics?, dry_run?
publish_x Tweet or thread on X text, thread?, url?, hashtags?, dry_run?
publish_xiaohongshu Post to Xiaohongshu title, body, images?, tags?, dry_run?
publish_wechat Publish to WeChat title, body, cover_image?, digest?, dry_run?
publish Generic — any of 18 platforms platform, title, body, tags?, url?, metadata?, dry_run?
submit_directory Submit to AI directory directory, name, url, description, category?, pricing?, dry_run?

All publish tools support dry_run: true for preview without posting.

Auth Tools (4)

Tool Description
auth_status Show auth status for all platforms
auth_set_cookie Save a cookie to .env (platform, cookie)
auth_qr_login QR code login for Xiaohongshu
auth_health_check Verify credentials are valid (platform)

Utility Tools (2)

Tool Description
list_platforms List all platforms with auth status
preview_content Preview content adaptation per platform (title, body, platforms?)

Usage in Claude Code

Natural Language

> Publish this article to Zhihu
> Post README.md to Dev.to and Medium
> Share this to all configured platforms

/publish Skill (Interactive)

> /publish

Guides you through: identify content, select platforms, check auth, preview, confirm, publish.

For *-社媒版.md files, auto-splits by ## headings into per-platform content.

Publisher Agent (Batch)

> Batch publish this to all platforms

Autonomous agent: reads content, checks auth, previews all, waits for confirmation, publishes sequentially, reports summary table.

Troubleshooting

Plugin not loaded

ls ~/.claude/plugins/promotion-agent/plugin.json  # Must exist
# Restart Claude Code

MCP Server not starting

cd ~/.claude/plugins/promotion-agent
pip install -e .
python server.py  # Should start and wait for stdio input

Cookies expire every 1-3 months. Re-extract:

python3 get_cookies.py

Juejin API "parameter error"

Juejin's publish API may reject requests. The system creates a draft — visit juejin.cn/editor/drafts to publish manually.

CSDN 403 Forbidden

CSDN's WAF may block API calls. Use the CSDN web editor to publish manually when this occurs.

Auth hook blocking calls

If publish calls are blocked, run auth_status to see what's missing, then configure the required credentials.

License

MIT

Contributors

KE
MIT License
Created February 17, 2026
Updated March 21, 2026
ava-agent/promotion-agent | GitHunt