aronhy / adtrender

AdTrender 
 开源的广告研究平台：采集 Facebook、Instagram、TikTok、Google / YouTube、Pinterest、Snapchat 公开广告，搜索、收藏、分析竞品素材。 
 An open-source ad research platform for cross-border e-commerce teams and agencies.
 AdTrender Cloud » 
 ·
 自托管文档 
 ·
 反馈问题 
想省去部署和采集节点运维，直接用 adtrender.com；想掌控数据，就用这个仓库在自己的服务器上部署。
## 功能
- **多平台广告库**：按关键词、平台、国家、素材类型搜索公开广告，查看广告详情、投放历史和广告主。
- **种子库与无人值守采集**：集中管理采集任务，采集节点按分配领取、断点续采、去重入库。
- **团队工作区**：组织、成员、收藏、笔记和分析按工作区隔离。
- **订阅与计费**：组织级订阅，接入 Stripe。
- **平台后台**：用户、组织、广告与采集状态的运营面板。
只展示能从公开来源观测到的事实；首次观测不等于首次投放，产品不会编造营收、点击或 ROAS。
## 技术栈
Wasp / Open SaaS · React · Node.js · PostgreSQL + Prisma · Playwright 采集器 · S3 兼容对象存储
| 目录 | 内容 |
| --- | --- |
| `apps/web` | Web 应用：官网、工作台、认证、团队、计费、API、数据库迁移 |
| `apps/worker` | 独立后台进程：采集调度、邮件、分析任务 |
| `apps/collector` | 各平台采集器与节点部署工具 |
| `packages/contracts` | 应用与 worker 共享的数据契约 |
| `deploy` | 自托管镜像、容器、反向代理、备份恢复与健康检查 |
| `scripts` | 构建、验证、发布脚本；`scripts/migration` 是旧数据导入工具 |
## 快速开始
### 用 Docker 自托管
需要一台装有 Docker 的服务器，并把 `你的域名`、`api.你的域名`、`s3.你的域名` 解析到这台机器。一条命令生成带随机密钥的 `.env`，再填好 SMTP 发信账号即可启动；Caddy 会自动申请 HTTPS 证书。
 [code] 
只想在本机试用时，把域名写成 `localhost`，会改用 Caddy 本地证书和自带的 Mailpit 收件箱（`http://127.0.0.1:8025`）：
 [code] 
打开 `https://localhost` 用上面的邮箱注册。各服务说明和升级、备份方法见 docs/self-hosting.md。
### 本地开发
需要 Node.js 24、PostgreSQL。完整配置项见 docs/self-hosting.md。
 [code] 
默认页面 `http://localhost:3000`，API `http://localhost:3001`。
## 参与贡献
欢迎提 Issue 和 Pull Request，流程见 CONTRIBUTING.md。发现安全问题请按 SECURITY.md 私下报告。
## 许可
MIT。`apps/web` 基于 Open SaaS 模板，其许可见 OPEN-SAAS-LICENSE。
采集公开广告数据时，请遵守各平台的服务条款和所在地区的法律法规。