<div align="center">
<img src="https://www.analook.com/assets/favicon-512x512.png" alt="Analook Logo" width="120" />
# Analook — 竞品情报分析工具
### 30 秒看透任何竞品 · AI-powered competitor intelligence for indie hackers & growth teams
[](https://opensource.org/licenses/MIT)
[](https://www.analook.com)
[](https://clawhub.ai/gingiris-1031)
[](https://railway.app)
**[English](#english) | [中文](#中文版)** · **[🤖 MCP Server](#-remote-mcp-server)** · **[📖 Docs](https://www.analook.com/docs/mcp.html)**
</div>
## 🤖 Remote MCP Server
Analook is available as a **Remote MCP server** — use it from Claude Desktop, Cursor, or any MCP-compatible client. No install, no local process.
```json
{
"mcpServers": {
"analook": {
"url": "https://www.analook.com/mcp",
"headers": { "Authorization": "Bearer <YOUR_ANALOOK_TOKEN>" }
}
}
}
```
**5 tools**: `analyze_competitor`, `get_report_status`, `get_report`, `get_report_markdown`, `list_my_reports`.
Full docs & token instructions → **[analook.com/docs/mcp](https://www.analook.com/docs/mcp.html)**
---
> 💡 **出海增长咨询 · 1v1 Session 约课 $200** — [Telegram @Iris_carrot](https://t.me/Iris_carrot)
>
> 或访问 **[gingiris.tools](https://gingiris.tools)** — Iris 的出海增长咨询，1:1 指导、开源项目运营、企业顾问服务
## Table of Contents
- [What is Analook](#what-is-analook)
- [Live Demo](#-live-demo)
- [Analysis Modules](#-analysis-modules)
- [AI Insights Depth](#-ai-insights-depth)
- [Quick Start](#-quick-start)
- [Deploy Your Own](#-deploy-your-own)
- [API Integrations](#-api-integrations)
- [Work With Iris](#-work-with-iris)
- [About the Author](#about-the-author)
- [中文版](#中文版)
---
> 🌱 **Philosophy**
>
> *"做竞品分析不是为了抄，是为了找到别人没做好的地方。"* — Competitor research isn't about copying — it's about finding the gaps they left open.
>
> *"数据会说话，但你得先知道问对问题。"* — Data speaks, but only if you ask the right questions.
>
> *"30 秒看懂一个产品，30 天超越它。"* — Understand a product in 30 seconds. Surpass it in 30 days.
---
> 💼 **Work With Iris**
>
> **1. Strategic Consultation (1v1)**
> | Session | Price | Best For |
> |:--------|:------|:---------|
> | Quick Call (30 min) | $150 USD | Specific questions, quick diagnosis |
> | Deep Dive (60 min) | $300 USD | Full strategy review, detailed roadmap |
>
> **2. Advisory Retainer**
> | Plan | Price | Includes |
> |:-----|:------|:---------|
> | Monthly Retainer | $1,500 USD/mo | Up to 5 hours strategic consultation + milestone reviews |
>
> **3. Playbooks & Templates**
> | Package | Price | Contents |
> |:--------|:------|:---------|
> | Starter Pack | $29 USD | Core methodology + essential tools |
> | Flagship Bundle | $199 USD | Complete SOP, competitor research framework, templates |
>
> 📩 [Contact @Iris_carrot on Telegram](https://t.me/Iris_carrot) — Crypto/USDT and Wire Transfer accepted
---
## What is Analook?
**Analook** is an open-source AI-powered competitor intelligence tool built by [Iris](https://gingiris.tools), former cofounder & COO of [AFFiNE](https://github.com/toeverything/AFFiNE) (60k+ stars).
Enter any product URL. In ~30 seconds, Analook runs a **7-module parallel analysis pipeline** and returns a structured deep-dive report — growth strategy, traffic signals, social footprint, ProductHunt history, AI insights, and more.
Built for:
- **Indie hackers** validating a market before building
- **Growth teams** benchmarking against competitors
- **Investors** doing quick pre-DD intelligence
- **Founders** preparing a launch in a crowded niche
### Analysis Results Include
| Signal | What You Learn |
|--------|----------------|
| 🌐 Website History | When launched, how fast it grew, Wayback timeline |
| 📈 Traffic & SEO | Monthly visits, top channels, keyword gaps |
| 🐦 Twitter / X | Followers, engagement rate, content strategy |
| 🚀 Product Hunt | Launch scores, positioning, community response |
| 💡 AI Deep Dive | ICP, business model, growth flywheel, tactical recs |
| 📡 Propagation | Peak traffic events, viral moments, channel breakdown |
| 🧠 Growth Strategy | Early-stage strategy reconstruction from public signals |
### What's Inside
This repo is the production backend powering **[analook.com](https://www.analook.com)**:
- **`app.py`** — FastAPI orchestrator: parallel analysis pipeline, job state, streaming, credit gating
- **`modules/`** — analysis engines (traffic, social, Product Hunt, growth analysis, AI summary) plus the Supabase client, payment integrations, and the MCP server (`mcp_app.py`)
- **`migrations/`** — Supabase SQL migrations (auth/credits/promo codes/attribution)
- **`scripts/`** — operational tooling: user metrics, attribution reports, EDM campaigns
- **`static/`** — the web UI served at analook.com
- **`tests/`** + `Dockerfile` — regression suite and container build
Stack: **FastAPI + Supabase** (auth, credits, report storage), deployed via Docker.
---
## 🔗 Live Demo
**[analook.com](https://www.analook.com)** — Free to use. No login required.
Try with: `lovable.dev` · `linear.app` · `notion.so` · `cursor.com`
---
## 📦 Analysis Modules
| Module | File | Description |
|--------|------|-------------|
| Website History | `modules/website_history.py` | Wayback Machine CDX API, first-seen date, snapshot timeline |
| Traffic & SEO | `modules/traffic_analysis.py` | DataForSEO — monthly visits, channels, top pages, keywords |
| Social Media | `modules/social.py` | Apify Twitter scraper — followers, engagement, recent content |
| Product Hunt | `modules/producthunt.py` | PH GraphQL API — launches, scores, upvotes, reviews |
| OSS Growth Attribution | `modules/oss_growth_attribution.py` | GitHub star stages, public channel evidence, representative content links, confidence scoring |
| Growth Analysis | `modules/growth_analysis.py` | Traffic peak detection, event correlation, growth stage |
| AI Summary | `modules/ai_summary.py` | 7-section structured analysis via TeamoRouter + DeepSeek fallback |
| Report Builder | `app.py` | FastAPI orchestrator — parallel pipeline, job state, streaming |
---
## 🧠 AI Insights Depth
Analook's AI module goes beyond surface-level summaries. Each report includes:
1. **产品定位与 ICP** — Target user profiles, market positioning, who actually pays
2. **商业模式拆解** — Pricing model, conversion hypothesis, revenue estimate range
3. **增长密码** — 4–6 data-backed growth strategies with evidence
4. **增长飞轮** — Product-specific flywheel reconstruction
5. **内容与传播策略** — Channel mix, content types, launch propagation model
6. **给后来者的战术建议** — 5 actionable recommendations you can execute this week
7. **风险与机会** — Red flags and market gaps, with data citations
Powered by **TeamoRouter** (primary) and **DeepSeek** (fallback), with max 4,000 token output per report.
---
## ⚡ Quick Start
```bash
git clone https://github.com/Gingiris-1031/Competitor-analysis-tool.git
cd Competitor-analysis-tool
pip install -r requirements.txt
```
Create a `.env` file:
```env
TEAMOROUTER_API_KEY=sk-teamo-...
DEEPSEEK_API_KEY=sk-...
DATAFORSEO_B64=base64(email:password)
PRODUCTHUNT_TOKEN=...
APIFY_API_TOKEN=apify_api_...
```
Run locally:
```bash
uvicorn app:app --reload --port 8000
```
Visit `http://localhost:8000`
---
## 🚀 Deploy Your Own
### Production source-of-truth
The production source is the `main` branch of
`Gingiris-1031/Competitor-analysis-tool`. Before any production deploy, run:
```bash
python3 scripts/verify_deploy_source.py
```
The preflight fails if the checkout is behind `origin/main`, is on the wrong
branch or remote, or is missing tracked SEO/GEO assets such as
`static/llms.txt`, `static/robots.txt`, and `static/sitemap.xml`. This prevents
an older local clone from silently removing live assets during deployment.
The current production Fly app is declared in `fly.toml` as
`competitor-analysis-tool`. Run the preflight from the same checkout immediately
before `fly deploy`.
### Self-hosting
One-click deploy on **Railway**:
[](https://railway.app/new/template)
**Steps:**
1. Fork this repo
2. Create a new Railway project → connect your fork
3. Add the environment variables above in Railway → Settings → Variables
4. Railway auto-deploys on every push to `main`
The app is Dockerized and uses **Nixpacks** on Railway (Python 3.13).
---
## 🔌 API Integrations
| Service | Purpose | Notes |
|---------|---------|-------|
| [TeamoRouter](https://teamo.ai) | Primary LLM | Routes to best available model |
| [DeepSeek](https://deepseek.com) | Fallback LLM | Cost-efficient backup |
| [DataForSEO](https://dataforseo.com) | Traffic & SEO data | Monthly visits, channels, keywords |
| [Apify](https://apify.com) | Twitter/X scraping | `apidojo/twitter-profile-scraper` actor |
| [ProductHunt](https://producthunt.com/v2/oauth/token) | Launch history | PH GraphQL API |
| [Wayback Machine](https://web.archive.org) | Website history | CDX API + timemap |
---
## ⭐ Star This Repo
If Analook saved you hours of manual research, a ⭐ helps others discover it!
---
## About the Author
**Iris (生姜iris)** — Former cofounder & COO of [AFFiNE](https://github.com/toeverything/AFFiNE) (60k+ GitHub stars). Now running **[Gingiris](https://gingiris.tools)** — an open-source go-to-market and global expansion consulting practice.
- 🐦 Twitter: [@WeiYipei](https://twitter.com/WeiYipei)
- 💬 Telegram: [@Iris_carrot](https://t.me/Iris_carrot)
- 🌐 Website: [gingiris.tools](https://gingiris.tools)
**Related Playbooks (now on ClawHub):**
- [@gingiris on ClawHub](https://clawhub.ai/gingiris-1031) — GTM strategy, B2B SaaS PLG/SLG growth, open source launch marketing, and other AI-agent skills
---
## 中文版
### Analook 是什么？
**Analook** 是一个开源 AI 竞品情报工具，由 [AFFiNE](https://github.com/toeverything/AFFiNE)（60k+ stars）联创 & 前 COO Iris 构建。
输入任意产品网址，30 秒内生成一份结构化竞品深度报告——包含增长策略、流量信号、社交足迹、ProductHunt 历史、AI 洞察等全套数据。
### 适合谁用？
- **独立开发者** — 开始动手前快速验证市场
- **增长团队** — 对标竞品，找到差距
- **投资人** — Pre-DD 快速情报收集
- **创始人** — 在红海市场找到进攻角度
### 核心分析模块
| 模块 | 数据来源 | 输出内容 |
|------|---------|---------|
| 🌐 网站历史 | Wayback Machine | 上线时间、成长速度、快照时间线 |
| 📈 流量 & SEO | DataForSEO | 月访问量、流量渠道、关键词矩阵 |
| 🐦 Twitter/X | Apify | 粉丝数、互动率、内容策略 |
| 🚀 Product Hunt | PH GraphQL | 发布记录、评分、社区反馈 |
| ⭐ 开源增长归因 | GitHub API + 公开内容检索 | Star 阶段、渠道证据、关键内容原链、证据置信度 |
| 💡 AI 深度分析 | TeamoRouter | ICP 画像、商业模式、增长飞轮、战术建议 |
| 📡 传播分析 | 综合 | 流量峰值事件、渠道来源、传播节点 |
| 🧠 早期增长策略 | 综合 | 从公开信号反推产品早期增长路径 |
### 快速部署
```bash
git clone https://github.com/Gingiris-1031/Competitor-analysis-tool.git
cd Competitor-analysis-tool
pip install -r requirements.txt
# 配置 .env 文件后：
uvicorn app:app --reload --port 8000
```
**Railway 一键部署：** Fork 本 repo → Railway 连接 → 添加环境变量 → 自动部署 ✅
### 关于作者
Iris（生姜iris），AFFiNE 联创 & 前 COO，现运营 [Gingiris](https://gingiris.tools) 开源出海增长咨询。
- 出海咨询预约：[gingiris.tools](https://gingiris.tools)
- Telegram：[@Iris_carrot](https://t.me/Iris_carrot)
- Twitter：[@WeiYipei](https://twitter.com/WeiYipei)
---
## License
MIT — free to use, modify, and redistribute.