XHS Toolkit — 小紅書(XHS)投稿・運用ツールキット

Tool

概要

XHS Toolkitは、小紅書(Xiaohongshu / XHS)向けの投稿作成・運用を効率化するツールセットです。HTML/CSSで「カード式」のビジュアルノートを作成し、Puppeteer(ヘッドレスChromium)でレンダリング→自動スクリーンショットを取得、さらにスクリプト化された手順で投稿までつなげられるワークフローを提供します。テーマカラーをCSS変数(—accent)で切り替えられるため、統一したブランドデザインや複数カラーのバリエーション作成が簡単。READMEやGUIDE、SKILLファイルでエージェント運用やテンプレート活用方法が整理されています。GitHub

リポジトリの統計情報

  • スター数: 6
  • フォーク数: 1
  • ウォッチャー数: 6
  • コミット数: 6
  • ファイル数: 9
  • メインの言語: JavaScript

主な特徴

  • HTML/CSSベースのカード型テンプレートで視覚的に整ったノートを生成
  • CSS変数でテーマ色を一括変更、複数バリエーションの高速生成が可能
  • Puppeteerを用いたレンダリング→自動スクリーンショット取得/投稿自動化
  • エージェント向けスキル定義(SKILL.md)や操作ガイド(GUIDE.md)を同梱

技術的なポイント

このプロジェクトはフロントエンドのレンダリングをローカルのHTML/CSSテンプレートで完結させ、ヘッドレスブラウザでピクセル単位の出力を得る設計が柱です。カードデザインはCSS変数(例:—accent)で色や装飾を切り替えるため、テーマの差し替えが容易でテンプレートの再利用性が高い。Puppeteer側では指定したビューポートでページをロードし、必要に応じてフォントや画像の読み込み完了を待ってから高解像度のスクリーンショットを取得します。スクリーンショットは小紅書の投稿フォーマット(縦画像やスライド形式)に合わせてトリミング・連結するワークフローを組めます。

自動投稿部分は認証やAPIの扱いがネックになるため、README/ GUIDEでは認証フローや手動トークン挿入、あるいはブラウザ自動操作(ログイン→投稿)といった実装パターンが示されている可能性があります。SKILL.mdはエージェント(自動化エージェントや生成AI)向けのプロンプトや操作手順を定義し、コンテンツ生成〜テンプレート注入〜スクショ取得〜投稿までを連携する運用を想定しています。

拡張性としては、テンプレートHTMLをプログラムから埋めるテンプレートエンジン(簡易な文字列置換やMustache等)を介在させることで、外部のテキスト生成AI(例:Claude等)と組み合わせて自動生成コンテンツを直に反映可能です。また、画像最適化、フォント埋め込み、キャッシュ管理、Puppeteerのheadless設定やデバイスピクセル比の調整といった運用面の調整で出力品質を制御できます。セキュリティ面では投稿自動化の認証情報管理やレート制限に注意が必要です。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitignore: file
  • GUIDE.md: file
  • README.md: file
  • SKILL.md: file
  • assets: dir

…他 4 ファイル

(README内に examples/deepseek-claude/output に出力画像のサンプルが含まれていることが確認できます)

まとめ

HTML/CSSとPuppeteerを組み合わせ、実用的な小紅書投稿ワークフローを提供するシンプルで拡張しやすいツールキットです。

リポジトリ情報:

READMEの抜粋:

📕 XHS Toolkit — 小红书 AI 自媒体工具包

用 HTML/CSS 制作精美卡片式小红书笔记,Puppeteer 自动截图和发布。

✨ 效果展示

Post #17「DeepSeek偷师Claude?」— 紫色系浅色笔记风

🎨 设计风格

浅色笔记风 — 暖白底 #FDF8F3 + 白色卡片 + 彩色左边框 + 轻阴影

每篇帖子一个主题色,通过 CSS 变量 --accent 一键切换:

| 主题 | 色值 | 效果 | |------|------|—…