🔥 CrossPulse — 跨境脉搏

AI 驱动的跨境电商市场监控系统 — 每日自动抓取、分析、推送市场情报

🌐 English | 🇨🇳 中文

---

✨ 什么是 CrossPulse？

CrossPulse 是一个自动化跨境电商市场监控系统，每天自动从多个数据源抓取市场信号，经过 AI 深度分析后生成结构化日报，推送到飞书群。

🎯 适合谁用？

• 📦 跨境电商卖家：每日了解平台政策变化、爆品趋势
• 📊 运营/选品人员：获取竞品动态、类目机会信号
• 🏢 电商团队：统一市场情报来源，辅助决策
• 🤖 AI Agent 爱好者：学习如何用 AI 做市场分析

---

🚀 核心功能

功能	说明
📡 多源数据采集	Google News RSS + Retail Dive + eCommerceBytes 等行业媒体
🏷️ 7+ 平台覆盖	Amazon、TikTok Shop、Shopify、Temu、SHEIN、eBay、Walmart
🧠 AI 深度分析	逐条分析市场信号，输出中文摘要、评分、建议
📊 4 维智能评分	重要性 / 趋势强度 / 商业价值 / 风险等级
📱 飞书推送	自动生成 Interactive Card 推送到飞书群
🔄 智能去重	URL + 标题双重去重，避免重复分析
📈 趋势追踪	连续热点标记 + 本周趋势对比
🔴🟡🟢 红绿黄灯	一句话市场判断（偏暖/平稳/承压）

---

📸 输出示例

日报包含：

📊 今日大盘结论（红绿黄灯市场判断）
📈 数据概览（抓取/新增/来源/平台/国家/类目）
🏢 重点平台变化（TikTok Shop / Amazon 动态）
🎯 机会信号 TOP 5（含中文摘要+评分+建议）
⚠️ 风险信号 TOP 5（含影响分析+应对建议）
🔍 竞品动态
🔥 爆品苗头
✅ 建议跟进事项
👀 明日继续观察方向

---

🏗️ 技术架构

┌─────────────┐    ┌──────────────┐    ┌─────────────┐    ┌──────────────┐
│  RSS 数据源  │───▶│  数据抓取+去重 │───▶│  AI 分析引擎  │───▶│  飞书推送     │
│ Google News  │    │  飞书 Bitable │    │ LLM/heuristic│    │ Interactive  │
│ Retail Dive  │    │  URL+标题去重  │    │ 4维评分+分类   │    │    Card      │
│ eCommerceByt │    └──────────────┘    └─────────────┘    └──────────────┘
└─────────────┘

分析模式

模式	原理	质量	依赖
llm	调用外部 LLM API 逐条分析	✅ 深度分析	API Key
heuristic	关键词匹配+中文映射+分类规则	⚡ 快速，有中文内容	无
agent	Agent 自身分析（最高质量）	✅✅ 最佳	无外部依赖

---

🛠️ 快速开始

1. 克隆仓库

git clone https://github.com/hooper-lee/crosspulse.git
cd crosspulse

2. 安装依赖

pip install -r requirements.txt

3. 配置

cp .env.example .env
# 编辑 .env 填入你的配置

4. 运行

# 正式运行（写入飞书 + 推送）
python3 -m src.run --config config.yaml

# 本地测试（不写入飞书）
DRY_RUN=true python3 -m src.run --config config.yaml

---

📁 项目结构

crosspulse/
├── src/
│   ├── run.py              # 主执行器
│   ├── analyzer.py         # 数据分析（heuristic / llm / agent）
│   ├── config.py           # 配置加载 + 环境变量展开
│   ├── dedup.py            # 去重逻辑
│   ├── feishu_bitable.py   # 飞书 API 封装
│   ├── models.py           # 数据模型
│   ├── report.py           # 报告生成 + 飞书卡片构建
│   └── sources.py          # RSS 数据源
├── templates/
│   └── daily_report.md     # 日报模板
├── references/             # 参考文档
├── config.example.yaml     # 配置模板
├── .env.example            # 环境变量模板
├── requirements.txt        # Python 依赖
└── LICENSE                 # MIT 协议

---

⚙️ 配置说明

配置项	说明	默认值
analysis.mode	分析模式：llm / heuristic / agent	llm
analysis.openai_model	LLM 模型名称	gpt-4o-mini
max_items_per_run	每次最多抓取条数	80
report.top_opportunities_count	机会信号 TOP N	5

---

🤝 贡献

欢迎 Issue 和 PR！

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建 Pull Request

---

📄 License

MIT License - 详见 LICENSE

---

🌐 English

What is CrossPulse?

CrossPulse is an AI-powered cross-border e-commerce market intelligence system. It automatically monitors 7+ platforms (Amazon, TikTok Shop, Shopify, Temu, SHEIN, eBay, Walmart), analyzes market signals, and generates structured daily reports.

Key Features

• 📡 Multi-source data collection (Google News RSS + industry media)
• 🧠 AI-powered analysis with Chinese summaries and scoring
• 📊 4-dimension scoring (importance / trend / business value / risk)
• 📱 Feishu (Lark) Interactive Card push notifications
• 🔄 Smart deduplication (URL + title hash)
• 📈 Trend tracking with streak detection

Quick Start

git clone https://github.com/hooper-lee/crosspulse.git
cd crosspulse
pip install -r requirements.txt
cp .env.example .env  # Edit with your config
python3 -m src.run --config config.yaml

---

Built with ❤️ for cross-border e-commerce sellers