Secretary 是一个自动化的社交媒体分析工具，专门用于监控和分析社交媒体平台上的内容，并通过 AI 进行智能分析。
它能自动抓取指定账号的最新发言，根据配置的提示词进行分析，并将结果推送到企业微信机器人、个人微信等渠道。
通过灵活配置提示词，可以针对财经、政治、科技等不同主题进行定制化分析。

✨ 主要功能

🌐 多平台支持：目前支持 Truth Social 和 Twitter
👥 多账号监控：每个账号可配置不同的分析提示词
🎯 定制化分析：通过提示词灵活定义分析主题和维度
🧠 AI 分析：支持任何符合 langchain 规范的 LLM 模型供应商
📢 灵活推送：支持企业微信机器人、个人微信、Bark 等多种推送方式
⚙️ 可扩展配置：不同账号可配置不同的推送目标

⚡ 安装说明

# 克隆项目
git clone https://github.com/zkd8907/secretary.git
cd secretary

# 推荐使用 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync

# 或传统 venv（不推荐）
python -m venv .venv
source .venv/bin/activate   # Linux/Mac
.venv\Scripts\activate      # Windows
pip install -e .

🔧 配置说明

环境变量（.env）

env

# Redis 配置
REDIS_URL=redis://your_redis_url

# LLM API 配置
LLM_API_MODEL=your_model_name
LLM_API_KEY=your_api_key
LLM_API_BASE=your_api_base_url

# Twitter 配置
TWITTER_SESSION=your_twitter_session
# 或
TWITTER_USERNAME=your_username
TWITTER_PASSWORD=your_password

# Truth Social 配置
TRUTHSOCIAL_TOKEN=your_token
# 或
TRUTHSOCIAL_USERNAME=your_username
TRUTHSOCIAL_PASSWORD=your_password

# 消息推送配置
WECOM_TRUMP_ROBOT_URL=your_wecom_robot_webhook_url
PRIVATE_BARK_URL=your_bark_push_url

# 调度器配置
SCHEDULE_INTERVAL_MINUTES=5
RUN_ON_START=false

监控账号配置（config/social-networks.yml）

yaml

social_networks:
  - type: truthsocial
    socialNetworkId: realDonaldTrump
    prompt: >-
      你现在是一名财经专家，请对以下发言进行分析...
    messengers:
      - url: $WECOM_TRUMP_ROBOT_URL
        method: POST
        headers:
          Content-Type: application/json
        body:
          msgtype: markdown
          markdown:
            content: "# [$poster_name]($poster_url) $post_time\n\n> $content\n\n$translation:zh-cn\n\n$ai_result\n\nOrigin: [$post_url]($post_url)"

▶️ 使用方法

定时执行（推荐）

bash

# 默认 5 分钟间隔
python scheduler.py

# 自定义间隔（10 分钟）
SCHEDULE_INTERVAL_MINUTES=10 python scheduler.py

# Docker 运行
docker run -e SCHEDULE_INTERVAL_MINUTES=10 your-image

单次执行

bash

python main.py

执行流程：

抓取配置账号的最新发言
根据提示词调用 AI 分析与翻译
生成分析报告
通过配置的推送通道发送结果

⚠️ 注意事项

Twitter 在中国大陆不可直接访问，Truth Social 在大陆和香港均不可访问，需代理或海外环境
登录后会生成 .tw_session 文件（已在 .gitignore 中）
prompt 字段仅支持 $content 和环境变量
messengers 中可使用的内置变量包括：
- $poster_name、$poster_url、$post_time、$content
- $translation:zh-cn、$ai_result、$post_url

✅ 总结

Secretary 通过 多平台监控 + AI 分析 + 灵活推送，让你可以自动化追踪社交媒体账号的发言，并快速获得定制化的分析结果。适合 财经研究、舆情监控、主题追踪 等场景。🚀

📦️项目地址

本文地址：https://blog.148668.xyz/index.php/archives/48/

如果对本文有什么问题或疑问都可以在评论区留言，我看到后会尽量解答。

🤖 Secretary —— 自动化社交媒体分析工具