自媒体文案助手

一个 Windows 本地桌面应用，也提供 MCP 服务，方便其他 Agent 直接调用同一套能力。

普通使用不需要准备热点接口、TikHub Key 或大模型 Key。打开程序后选择图片，点击“刷新热点”或“生成可直接发布的成品文案”即可。没有外部接口时，程序会自动使用内置选题和本地图片分析生成草稿。

功能

• 小红书、抖音选题/热点辅助
• 本地图片尺寸、明暗、色调、画幅分析
• 可选调用用户自己的 OpenAI-compatible 大模型
• 未配置大模型时自动生成本地模板草稿
• 第三方热点接口不可用时自动降级到内置选题
• 输出一条可直接复制发布的成品文案，不输出 Markdown 方案稿
• 桌面端支持一键复制生成结果
• MCP 端可被其他 Agent 通过 stdio 调用
• 支持打包为 .exe，本地双击运行桌面端，或作为 MCP 进程启动

桌面端运行

python -m pip install -r requirements.txt
python main.py

桌面端打包 EXE

.\build_exe.ps1

生成文件：

dist\MediaCopyAssistantNoApi\MediaCopyAssistantNoApi.exe

MCP 服务

MCP 入口：

python mcp_server.py

MCP 使用 stdio transport，适合 Claude Desktop、Codex、OpenClaw 或其他支持 MCP 的 Agent 启动。

MCP 工具

fetch_hot_topics

获取指定平台热点/选题列表。

参数：

{
  "platform": "xiaohongshu",
  "limit": 10
}

analyze_image

分析本地图片的尺寸、画幅、明暗和主色调。

参数：

{
  "image_path": "D:\\path\\image.jpg"
}

generate_ready_copy

核心工具：结合图片识别和热点/选题，生成可直接复制发布的成品文案。

参数：

{
  "image_path": "D:\\path\\image.jpg",
  "platform": "xiaohongshu",
  "user_brief": "这是一张手办图片，想发小红书",
  "hot_topic": "",
  "limit": 8,
  "use_vision_model": true,
  "use_llm_model": true
}

返回值中的 copy_text 就是可直接粘贴使用的成品文案。

如果其他 Agent 只想快速走本地模板，不调用任何大模型，可传：

{
  "use_vision_model": false,
  "use_llm_model": false
}

MCP 配置示例

不同 Agent 的配置文件位置不同，但命令结构类似：

{
  "mcpServers": {
    "media-copy-assistant": {
      "command": "python",
      "args": ["D:\\wendang\\自媒体文案助手\\mcp_server.py"]
    }
  }
}

如果想使用打包后的 MCP exe：

{
  "mcpServers": {
    "media-copy-assistant": {
      "command": "D:\\wendang\\自媒体文案助手\\dist\\MediaCopyAssistantMCP\\MediaCopyAssistantMCP.exe",
      "args": []
    }
  }
}

MCP 打包 EXE

.\build_mcp_exe.ps1

生成文件：

dist\MediaCopyAssistantMCP\MediaCopyAssistantMCP.exe

注意：MCP exe 是给 Agent 启动的 stdio 服务，不是给人双击使用的桌面窗口。桌面窗口请用 MediaCopyAssistantNoApi.exe。

输出格式

生成结果只包含：

标题：...

正文：...

话题：#... #... #...

不会输出 ###、---、序号、备选标题、发布建议等 Markdown 或方案稿内容。

配置说明

程序里的“可选配置”只用于增强效果，不是必填项。

• 不填 API Key：仍然可以生成本地模板草稿
• 填写 API Key：会调用你自己的大模型生成更完整的图片理解和文案
• 热点接口：默认自动获取；接口不可用时自动切换到内置选题
• TikHub Key：代码里预留了支持，但普通用户不需要填写

配置文件位置：

%APPDATA%\MediaCopyAssistant\config.json

如需高级自定义，可在配置文件里修改：

{
  "douyin_hot_url": "https://v2.xxapi.cn/api/douyinhot",
  "xhs_hot_url": "",
  "tikhub_api_key": ""
}

项目结构

main.py                 桌面程序入口
mcp_server.py           MCP stdio 服务入口
src/app.py              Tkinter 桌面界面
src/config.py           本地配置读写
src/hotlists.py         热点抓取、接口失败降级、内置选题
src/image_analysis.py   图片基础识别
src/llm_client.py       OpenAI-compatible 大模型调用
src/copywriter.py       文案生成逻辑
src/mcp_server.py       MCP 工具定义
build_exe.ps1           桌面 EXE 打包脚本
build_mcp_exe.ps1       MCP EXE 打包脚本

说明

小红书公开热榜接口并不稳定，常见方案是浏览器 Cookie 或第三方数据服务。本工具默认不强制用户准备这些服务，优先保证本地可用。

本工具只做内容辅助，不自动发布内容。生成结果应由用户人工确认后再使用，避免虚假承诺、夸大宣传或搬运他人内容。