Metadata-Version: 2.4
Name: ai-netcafe
Version: 1.2.0
Summary: Zero-install toolbox for AI agents: web search, page-to-markdown, diagrams, transcription, PDF, cross-session memory, one-sentence app deployment, and a real per-call model cost dataset.
Project-URL: Homepage, https://ainetcafe.com/mcp.html
Project-URL: Documentation, https://ainetcafe.com/llms.txt
Project-URL: Repository, https://github.com/mario03690/netcafe-sdk
Project-URL: Cost dataset, https://ainetcafe.com/costs
Author-email: AI NetCafe <mario154156@gmail.com>
License: MIT
Keywords: agent,ai-tools,llm,llm-cost,mcp,mermaid,model-context-protocol,model-pricing,web-search,whisper
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# ai-netcafe

给 AI agent 的一套工具,**零依赖、不用注册就能开始**。匿名有免费额度,每次调用都会告诉你花了多少钱。

```bash
pip install ai-netcafe
```

```python
from ai_netcafe import NetCafe
nc = NetCafe()                        # 匿名;NetCafe(key="sk-...") 提额 + 跨设备记忆

nc.search("MCP 协议 2026")             # 联网搜索
nc.read("https://example.com")         # 网页 → 干净 Markdown
nc.diagram("graph TD; A-->B")          # Mermaid/PlantUML/Graphviz → SVG
nc.transcribe("https://x.com/a.mp3")   # 语音 → 文字
nc.remember("决定用 Fastify")           # 跨会话、跨设备的记忆
nc.build("一个番茄钟,可自定义时长")       # ★ 一句话造一个真正在线的应用
nc.costs()                             # 各模型同题实际收费(见下)
```

不装任何东西也能用 —— 任何能发 HTTP 请求的 agent 现在就能调:

```bash
curl "https://ainetcafe.com/t/web_search?query=MCP+protocol+2026"
```

## 同一道题,各模型实际收费差多少(CC BY 4.0)

厂商公布的是「每百万 token 多少钱」。但一次调用花多少钱,取决于**模型自己愿意吐多少 token** ——
同一道题,有的模型二十几个 token 收工,有的写四百个。我们每晚把固定的题(temperature 0)发给
每个模型,按各家真实上报的用量算实付:

**short_answer** — 最贵的比最便宜的贵 **26.6 倍**

| 模型 | 这道题实付 | tokens 入/出 |
|---|---|---|
| `deepseek-v4-flash` | $0.000152 | 26 / 201 |
| `GLM5.2` | $0.000742 | 34 / 200 |
| `claude-sonnet-5` | $0.000994 | 21 / 116 |
| `gemini-3.5-flash` | $0.001351 | 688 / 73 |
| `claude-opus-4-8` | $0.002124 | 21 / 102 |
| `Kimi-K3` | $0.002239 | 28 / 181 |

截至 2026-08-06,窗口 30 天,中位数倍差 **26.6 倍**。
完整数据(三类任务 × 全部模型)与方法论:<https://ainetcafe.com/costs>

## 接进你的 agent(一行)

```bash
ai-netcafe install
# 或者
claude mcp add --transport http ai-netcafe https://ainetcafe.com/mcp
```

23 个工具会直接出现在 Claude Code / Cursor 里。文档:<https://ainetcafe.com/mcp.html>

## 全部能力

| 方法 | 做什么 |
|---|---|
| `search` | 联网搜索(自托管元搜索,无追踪) |
| `read` | 任意网页 → LLM 友好的 Markdown |
| `diagram` / `diagram_url` | Mermaid/PlantUML/Graphviz → SVG/PNG |
| `transcribe` | 音频 URL → 文字稿(开源 Whisper,自托管) |
| `grammar` | 30+ 语言语法/拼写/风格检查 |
| `pdf` | 网页或 HTML → 打印级 PDF |
| `translate` | 文本翻译 |
| `ask` / `compare` | 单模型问答 / 多模型对比(含真实计量成本与延迟) |
| `models` / `costs` | 模型标价 / **同题实际收费** |
| `remember` / `recall` | 跨会话记忆;带 Key 时跨设备、跨 agent 共享 |
| `build` | **一句话造一个真正在线的应用**,约 100 秒返回 HTTPS 网址,归你所有 |

## 许可

MIT。成本数据集以 CC BY 4.0 发布。
