xhs-ai-writer  by EBOLABOY

AI viral content generator for social media creators

Created 10 months ago
273 stars

Top 94.5% on SourcePulse

GitHubView on GitHub
Project Summary

This project provides an AI-powered tool specifically designed for Xiaohongshu content creators to generate high-quality, engaging "viral" posts. It analyzes popular notes to extract successful formulas and then crafts human-like copy, aiming to significantly improve content creation efficiency and effectiveness for creators on the platform.

How It Works

The core innovation lies in its "Dual Expert System." An "Analysis Expert" deconstructs trending Xiaohongshu posts into reusable formulas for titles, content structure, and cover styles. A "Creation Expert" then injects genuine emotion and natural language, removing AI-generated stiffness. This is further bolstered by a "Triple Security Guarantee" encompassing format stability, content safety (sensitive word filtering), and validation integrity, ensuring reliable and safe output.

Quick Start & Requirements

  • Installation: Requires Node.js 18+ and npm or yarn. Install dependencies with npm install.
  • Configuration: Copy .env.local and fill in THIRD_PARTY_API_URL, THIRD_PARTY_API_KEY, AI_MODEL_NAME (e.g., gemini-2.5-pro,gemini-2.5-flash), ENABLE_CACHE (true/false), and optionally XHS_COOKIE.
  • Run: Execute npm run dev and access at http://localhost:3000.
  • Links: Deployment to Vercel is supported.

Highlighted Details

  • Dual Expert System: Combines analytical deconstruction of viral content with creative, human-like text generation.
  • Triple Security: Ensures format stability, filters over 105 sensitive words, and includes multi-layer validation with intelligent error recovery.
  • Multi-Model Fallback: Supports multiple AI models (e.g., Gemini, GPT) with automatic switching and retries for high availability.
  • Intelligent Caching: Built-in system to speed up responses and reduce API calls, configurable via .env.local.
  • User Experience: Features responsive design, streaming generation feedback, and individual module copy buttons.

Maintenance & Community

Developed by a Xiaohongshu creator focused on AI tools and content creation. Community interaction and feedback are encouraged via direct messages on the author's Xiaohongshu account.

Licensing & Compatibility

Licensed under the MIT License, generally permissive for commercial use and integration.

Limitations & Caveats

Requires integration with third-party AI services (OpenAI compatible) and necessitates API keys. An optional Xiaohongshu cookie is recommended for data scraping. The tool is specifically tailored for the Xiaohongshu platform and its content style.

Health Check
Last Commit

2 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
20 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.