agentscout (auxito/AgentScout) | MoltPulse

Back to Directory

agentscout

auxito/AgentScout00

Molt Pulse

0

Growth0/30

Activity0/25

Popularity0/25

Trust0/20

2

Stars

High

Sentiment

Votes

2

README.md

<div align="center">

🔍 AgentScout

GitHub Agent 项目自动发现 × 小红书内容一键生成

功能介绍 · 快速开始 · 使用指南 · 配置说明 · 项目结构 · 贡献指南

</div>

🤔 这是什么？

你是否经常在 GitHub 上刷到很酷的 AI Agent 项目，想分享到小红书，但从写文案到做配图要花一整晚？

AgentScout 帮你把这个过程缩短到 5 分钟。

它会自动搜索 GitHub 上最新、最有趣的 AI Agent 开源项目，用 LLM 打分排名，然后为你选中的项目一键生成：

📖 结构化分析教程 — 从架构到上手，每一步都写清楚
✍️ 小红书爆款文案 — 标题、正文、标签，拿来就发
🖼️ 6~9 张精美配图 — 封面、代码卡片、步骤图、总结卡，全套齐活

<div align="center">

GitHub 搜索 → LLM 评分排名 → 展示 Top3 → 深度分析 → 文案 + 配图 → 直接发布

</div>

✨ 功能特性

🔍 智能项目发现

多策略搜索：关键词搜索 + 组织监控（langchain-ai / microsoft / openai 等 7 个组织）
自动去重：SQLite 持久化，不会重复推荐同一个项目
实时数据：直接调用 GitHub API，获取最新 star 数、更新时间、topics 等

📊 LLM 四维评分

每个项目从 4 个维度打分（1-10 分），加权计算总分：

| 维度 | 权重 | 评什么 | |------|------|--------| | 🆕 新颖度 | 30% | 是否提出新范式/新思路 | | 🔧 实用性 | 30% | 能否解决真实痛点 | | 📱 内容适配度 | 25% | 适不适合做小红书内容 | | 🚀 易用性 | 15% | 上手难度如何 |

<div align="center"> </div>

git clone https://github.com/auxito/AgentScout.git
cd AgentScout

# 安装依赖
pip install -r requirements.txt

# （可选）安装 Playwright，用于 GitHub 页面截图
playwright install chromium

cp .env.example .env

# 必填
GITHUB_TOKEN=ghp_xxxxxxxxxxxx
LLM_API_KEY=sk-xxxx

# 可选 - LLM 配置（默认 OpenAI）
LLM_BASE_URL=https://api.openai.com/v1
LLM_MODEL=gpt-4o

# 可选 - AI 配图（支持任意 OpenAI 兼容的图片 API）
IMAGE_API_KEY=sk-xxxx
IMAGE_BASE_URL=https://api.siliconflow.cn/v1
IMAGE_MODEL=black-forest-labs/FLUX.1-schnell

python -m src.pipeline

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  📡 搜索     │────▶│  📊 评分     │────▶│  🏆 排名     │
│  GitHub API  │     │  LLM 四维   │     │  展示 Top3   │
└─────────────┘     └─────────────┘     └──────┬──────┘
                                                │ 用户选择
                                                ▼
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  📦 产出     │◀────│  🎨 配图     │◀────│  📖 分析     │
│  output/    │     │  6-9 张图   │     │  深度教程    │
└─────────────┘     └─────────────┘     └─────────────┘

output/2026-03-16_CoolProject/
├── analysis.md        # 结构化分析教程
├── post.md            # 小红书文案（含标签，可直接复制发布）
├── images/            # 所有配图
│   ├── P1_cover.png
│   ├── P2_terminal.png
│   ├── P3_architecture.png
│   ├── P4_code.png
│   ├── P5_code.png
│   ├── P6_steps.png
│   ├── P7_steps.png
│   ├── P8_concept.png    # AI 生成（需配置 IMAGE_API_KEY）
│   ├── P9_summary.png
│   └── github_screenshot.png
└── metadata.json      # 项目元数据 + 评分详情

AgentScout/
├── src/
│   ├── pipeline.py                # 主流程编排（6 个阶段串联）
│   ├── config.py                  # 统一配置加载
│   │
│   ├── discover/                  # 🔍 项目发现
│   │   ├── github_searcher.py     #    GitHub 搜索 + 组织监控
│   │   ├── scorer.py              #    LLM 四维评分
│   │   └── ranking.py             #    TopK 排行榜
│   │
│   ├── analyze/                   # 📖 深度分析
│   │   └── project_analyzer.py    #    README/代码 → 结构化教程
│   │
│   ├── content/                   # ✍️ 内容生成
│   │   ├── copywriter.py          #    小红书文案
│   │   └── tag_generator.py       #    智能标签
│   │
│   ├── visual/                    # 🎨 配图系统
│   │   ├── composer.py            #    HTML 模板 → 图片
│   │   ├── code_card.py           #    Carbon 风格代码卡片
│   │   ├── screenshot.py          #    Playwright 网页截图
│   │   └── ai_image.py            #    AI 概念配图
│   │
│   ├── storage/                   # 💾 数据存储
│   │   ├── database.py            #    SQLite CRUD
│   │   └── models.py              #    数据模型
│   │
│   └── utils/                     # 🔧 工具层
│       ├── llm_client.py          #    OpenAI 兼容 LLM 客户端
│       └── image_client.py        #    OpenAI 兼容图片客户端
│
├── templates/                     # HTML 卡片模板（3 种配色）
├── output/                        # 生成的内容产出
├── data/                          # SQLite 数据库
├── .env.example                   # 环境变量模板
└── requirements.txt               # Python 依赖