This project provides an AI-powered social media automation skill for Claude Code, enabling users to post content across various platforms using natural language commands. It targets users of AI programming assistants seeking efficient, resilient content publishing workflows, offering a significant reduction in manual effort and improved adaptability to website changes compared to traditional scripting methods.

How It Works

The skill leverages agent-browser, an AI-driven browser automation tool, integrated with Claude Code's skill system. Instead of relying on brittle CSS selectors, agent-browser uses AI to interpret web page elements, making workflows robust against UI updates. This approach minimizes token consumption and execution time. Workflows are defined in Markdown files within the references/ directory, allowing for easy addition of new platforms or modification of existing posting logic through declarative configuration.

Quick Start & Requirements

• Installation:
  1. Install agent-browser CLI: npm install -g agent-browser
  2. Install agent-browser skill: npx skills add https://github.com/vercel-labs/agent-browser --skill agent-browser
  3. Install Chromium: agent-browser install
  4. Add the social-push skill: npx skills add jihe520/social-push
• Prerequisites: Claude Code, Node.js/npm, agent-browser, Chromium browser.
• Setup: Initial manual login may be required for certain platforms to save session state. Refer to the detailed instructions in the README for connecting to a running browser instance.
• Links: agent-browser, Claude Code (implied).

Highlighted Details

• AI-Driven Posting: Initiate posts via simple commands in Claude Code (e.g., /social-push "Post this article to Xiaohongshu").
• Self-Evolution: Workflows can automatically detect and repair issues caused by website redesigns.
• Multi-Platform Support: Out-of-the-box support for Xiaohongshu (image/text, long-form), X/Twitter, Zhihu, Weibo, WeChat Official Account, Juejin, and Linux do, with easy extensibility.
• Configuration: New platforms can be added by creating Markdown files, abstracting away complex scripting.
• State Management: Supports saving login states (--state) and browser profiles (--profile) for persistent sessions.

Maintenance & Community

The project structure includes a SKILL.md for skill definition and a references/ directory for platform-specific workflow definitions, facilitating contributions. Specific community links (Discord/Slack) or active maintainer information are not detailed in the provided README.

Licensing & Compatibility

The license is not explicitly stated in the provided README. Compatibility for commercial use or linking with closed-source projects cannot be determined without a specified license.

Limitations & Caveats

Some platforms may require a manual, one-time login process to establish a stable session state. Using browser profiles (--profile) might introduce compatibility issues with certain websites. The skill saves drafts but does not automatically publish, requiring user confirmation before final posting.