Metadata-Version: 2.4
Name: deeplook-research
Version: 0.1.0
Summary: Company intelligence for AI agents — any company, one call
License: AGPL-3.0
Project-URL: Homepage, https://github.com/OSOJDJD/deeplook
Project-URL: Repository, https://github.com/OSOJDJD/deeplook
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: anthropic
Requires-Dist: openai
Requires-Dist: google-genai
Requires-Dist: httpx
Requires-Dist: beautifulsoup4
Requires-Dist: duckduckgo-search<7.0,>=6.0
Requires-Dist: yfinance
Requires-Dist: mcp>=1.9.0
Requires-Dist: fastapi>=0.111.0
Requires-Dist: uvicorn[standard]>=0.29.0
Requires-Dist: yt-dlp
Requires-Dist: python-dotenv
Requires-Dist: wikipedia-api
Requires-Dist: finnhub-python
Dynamic: license-file

# DeepLook

LLMs hallucinate financial data. DeepLook gives them real numbers instead.

[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
[![GitHub stars](https://img.shields.io/github/stars/OSOJDJD/deeplook?style=social)](https://github.com/OSOJDJD/deeplook)

## What happens when you ask "Research NVIDIA"

![DeepLook Dashboard](docs/screenshot-dashboard.png)

![DeepLook Analysis](docs/screenshot-analysis.png)

DeepLook provides structured context — real-time data from 8 APIs combined with analytical instructions that makes better output. The result:

- **Accurate, up-to-date information** — not hallucinated numbers
- **Clear at a glance** — financials, peers, technicals, news in one view
- **Better AI output** — because good context drives good analysis

Works for financial research, business due diligence, or any use case where you need to understand a company fast.

---

## Get started

### Claude.ai

1. Go to **Settings → Connectors → Add MCP**
2. Paste: `https://mcp.deeplook.dev/mcp`
3. Start a new chat and ask: *"Research NVIDIA"*

### Other MCP clients (Cursor, VS Code, Windsurf, Claude Desktop)

```json
{
  "mcpServers": {
    "deeplook": {
      "url": "https://mcp.deeplook.dev/mcp"
    }
  }
}
```

### Claude Code

```bash
claude mcp add --transport http deeplook https://mcp.deeplook.dev/mcp
```

### Self-host

```bash
git clone https://github.com/OSOJDJD/deeplook.git
cd deeplook
pip install -r requirements.txt
python -m deeplook.mcp_server
```

---

## What it covers

| Type | Examples |
|------|----------|
| Public stocks | NVIDIA, Apple, Tesla, TSMC |
| Crypto | Bitcoin, Solana, Ethereum |
| Private companies | Anthropic, Stripe, OpenAI |
| VC firms | a16z, Sequoia |
| Defunct | FTX, WeWork |

---

## Extend DeepLook

DeepLook covers the basics. If you need data it doesn't have yet — a new market, a new data source, a new analysis rule — you can add it. See [CONTRIBUTING.md](CONTRIBUTING.md).

---

## Roadmap

- [ ] More query tools — news, peers, financials, calendar as standalone lookups
- [ ] Broader client support — Cursor, ChatGPT, VS Code, Windsurf, Claude Code
- [ ] Deeper context — more analytical conditions, entity-specific instructions
- [ ] Community contributions — new data sources, custom analysis rules

---

## License

[AGPL-3.0](LICENSE)

---

Built by [@OSOJDJD](https://github.com/OSOJDJD)
