trueai

真选AI (TrueAI) — 次世代 AI ナビゲーション、あなたを理解します

あなたの出費と時間を節約します。 データはリアルタイムで更新、人による評価、広告なし。 最高のものはなく、あなたに最適なものがあるだけです。

TrueAI は、AI ツールを対象とする エージェントによるおすすめ＋人による評価＋対話型ナビゲーション プラットフォームの MVP です。 ユーザーは次のことができます。

• カテゴリ別に整理された AI ツールのカード一覧を閲覧する（吊り下げられたカードが軽く揺れるアニメーション付き）
• 対話形式で 「あなたを理解する」 アシスタントに質問を返してもらい、おすすめを受け取る（ストリーミング SSE）
• 多角的なランキングを確認する。「自然言語で自分専用のランキングを作成」にも対応
• 最大 3 つのツールを比較ドロワーに追加し、横並びで多角的に比較する
• ツールの評価を閲覧／投稿する（審査を通過すると現金報酬を受け取れます。MVP ではテーブル構造のみ保持）

🤖 AI エージェントを接続する（MCP / Skill）

TrueAI の 1600 以上のアプリカタログは MCP Server と 単一ファイルの Skill としてパッケージ化されており、エージェントが 「AI ツールを選ぶ」機能を直接利用できます。詳細なドキュメント：skills/trueai/SKILL.md。

1 行で MCP に接続（Claude Desktop / Cursor / Cline / Continue / Windsurf）

{ "mcpServers": { "trueai": { "url": "https://www.shiflowai.cloud/mcp" } } }

接続すると、エージェントはすぐに 4 つのツールを利用できるようになります。

ツール	用途
recommend_ai_tools(description, top_k)	ユーザーの自然言語による要望 → 適切なアプリをおすすめ
get_ai_tool(name_or_url, include_reviews)	名前／slug／公式サイト URL → アプリの詳細情報
list_ai_tools(category, free_only, ...)	カテゴリ／形態／無料かどうかでカタログを閲覧
list_categories()	すべてのカテゴリを一覧表示

MCP がなくても使えます——そのまま使える Skill ファイル

skills/trueai/SKILL.md を任意のエージェントの skills ディレクトリにコピーすると、 エージェントはドキュメント内の curl の例に従って https://www.shiflowai.cloud/api/* を直接呼び出します。

データスキーマ

各 AI アプリには 34 個の構造化フィールド（評価／価格／形態／レビュー／リンクなど）があります。 完全な JSON Schema：docs/ai_tool_schema.json。

🕷️ データの取得元：StructAIWeb（コア収集エージェント）

TrueAI のサイトにある 1600 以上のアプリの構造化フィールド——名前、ロゴ、キャッチコピー、料金、サブ機能一覧、 使いやすさ／効果／コストパフォーマンスの評価など——は、手作業で入力されたものではありません。別のオープンソースプロジェクトである StructAIWeb が自動で収集しています。 これは TrueAI のデータパイプラインの 中核 AI エージェント です。

項目	説明
リポジトリ	https://github.com/chenyujing1234-netizen/StructAIWeb
形態	Windows デスクトップ GUI ＋ CLI（Python ＋ Playwright）
ブラウザー	CDP 経由で、ローカルですでにログイン済みの Chrome を操作します。Cookie／拡張機能をそのまま利用でき、多くの不正利用対策を回避できます
探索	ヒューリスティックに「価格 → 機能 → 概要 → ドキュメント」の順でサイトを巡回し、CTA を自動クリックして主要機能エリアに入ります
試用	プロンプトを入力して「生成／送信」をクリックします。「購入／チャージ／サブスクリプション」ボタンは決してクリックしません
視覚	マルチモーダル視覚モデル（Qwen-VL / GPT-4o / GLM-4V）を有効にして、「どのボタンをクリックすべきか」を認識できます
ログイン画面	自動検出して一時停止し、ログイン完了後に再開します
統合	すべてのページスナップショットを LLM に渡し、構造化 JSON と 3 項目の主観評価（usability / effect / price）を出力します
出力フィールド	docs/ai_tool_schema.json と 完全に一致
ライセンス	MIT

簡単に言うと：

StructAIWeb は「AI サイトを理解する」役割を担い、TrueAI は「理解した数千件の結果をまとめ、あなたを理解するナビゲーションサイトにする」役割を担います。

自分でデータを収集したり、さらに多くの AI ツールを追加したりするには、StructAIWeb を fork し、実行後に output/*.json を TrueAI の backend/scripts/sync_*.py 登録スクリプトに読み込ませます。

技術スタック

レイヤー	採用技術
バックエンド	Python 3.10+ / FastAPI 0.115 / SQLAlchemy 2 / Alembic / PyMySQL
フロントエンド	Next.js 14 (App Router, 純粋な JavaScript) / Tailwind CSS / Framer Motion / Zustand
データベース	MySQL 8 (114.55.254.123:3306/trueai)
LLM	Alibaba Cloud DashScope (qwen-plus)、Key が設定されていない場合は Mock の文言に自動でフォールバック
認証	JWT (python-jose) ＋ bcrypt

ディレクトリ構成

TrueAI/
├── backend/              # FastAPI 服务
│   ├── app/
│   │   ├── core/         # 配置 / DB / 安全
│   │   ├── models/       # ORM 模型
│   │   ├── schemas/      # Pydantic
│   │   ├── api/routers/  # auth / categories / tools / reviews / rankings / stats / search
│   │   ├── services/llm/ # Qwen 与 Mock 两种 Provider
│   │   ├── services/recommend.py  # 意图抽取 + MySQL 候选召回
│   │   └── seeds/seed_tools.py
│   ├── alembic/
│   └── requirements.txt
└── frontend/             # Next.js 14
    ├── app/              # layout / page / category / tool / search / rankings / compare / earn
    ├── components/       # NavBar / HeroTypewriter / Sidebar / ToolCard / CompareBar / ChatSearch ...
    ├── lib/              # api.js / compareStore.js / labels.js
    └── tailwind.config.js

クイックスタート

前提条件：Python 3.10+、Node 20+ がインストール済みで、MySQL 114.55.254.123:3306 にアクセスできること。

1. バックエンド

cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env    # 按需改 JWT_SECRET / DASHSCOPE_API_KEY

# 首次：执行数据库迁移 + 种子数据
alembic upgrade head
python -m app.seeds.seed_tools

uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
# http://localhost:8000/docs 查看 OpenAPI

2. フロントエンド

cd frontend
npm install
cp .env.local.example .env.local   # 默认指向 http://127.0.0.1:8000
npm run dev
# 打开 http://localhost:3000

環境変数

backend/.env

変数	説明
DATABASE_URL	mysql+pymysql://user:pass@host:3306/trueai の形式です。パスワードに特殊文字が含まれる場合は URL エンコードが必要です（@ → %40）
JWT_SECRET	JWT 署名キー。本番環境では長いランダム文字列に置き換えてください
JWT_EXPIRES_MINUTES	トークンの有効期限（分）。デフォルトは 7 日です
LLM_PROVIDER	qwen（デフォルト）。空の場合、または Key がない場合は自動で Mock にフォールバックします
DASHSCOPE_API_KEY	通義千問の Key。DashScope コンソールで作成します
QWEN_MODEL	デフォルトは qwen-plus です。qwen-turbo／qwen-max に変更できます
CORS_ORIGINS	許可するフロントエンドの origin。カンマ区切りです

frontend/.env.local

変数	説明
NEXT_PUBLIC_API_BASE	バックエンドの Base URL。開発環境のデフォルトは http://127.0.0.1:8000 です

フロントエンドからのすべての /api/* リクエストは、Next.js 側で rewrites を通じてバックエンドにプロキシされるため、ブラウザーの CORS の問題を回避できます。

核心 API

接口	说明
GET /api/health	健康检查
GET /api/stats	首页横幅用：工具数 / 分类数 / 评测数 / 价值观文案
GET /api/categories	全部分类 + 每类工具数
GET /api/tools	列表 + 多维筛选 + 排序 + 分页
GET /api/tools/{id 或 slug}	智能体详情
POST /api/tools/compare	对比（body 为 id 列表）
GET /api/rankings?dimension=&category=&top=	排行榜
POST /api/reviews	提交评测（需 Bearer token）
GET /api/reviews?tool_id=&status_filter=approved	评测列表
POST /api/search/chat	对话搜索，SSE 流：event: meta + 多个 event: delta + event: done
GET /api/search/chat?q=...	非流式兜底：直接给候选和外部导航
POST /api/auth/register / /login / GET /api/auth/me	注册 / 登录 / 查询当前用户

种子数据自带一个管理员账号：admin / admin123456（生产请删除或改密）。

"懂你"对话搜索的工作方式

1. 客户端把当前会话（含历史）POST 到 /api/search/chat。
2. 后端根据最新 user 消息，用关键词字典抽取 类目 / 人群 / 免费 / 国内直连 等意图。
3. 先从 MySQL 召回 ≤ 6 个候选，立即通过 event: meta 推送给前端（前端马上渲染卡片）。
4. 接着把系统 Prompt + 候选摘要 + 会话历史交给 Qwen 流式输出，按字/片推送 event: delta。
5. 若候选为空，meta 中带 external 外部 AI 导航站清单，前端展示"去别家看看"。

常见问题

• ValueError: invalid interpolation syntax：Alembic 读 % 会报错。alembic/env.py 已做 % → %% 转义。
• pymysql 连接慢 / 超时：pool_pre_ping=True、pool_recycle=3600 已打开；请确认 MySQL 白名单已允许你的出口 IP。
• 前端 API 跨域：开发期通过 next.config.js rewrites 代理，无需额外处理。部署时建议把后端放到同域 /api/* 路径下。
• Qwen 没配 Key：/api/search/chat 会自动回退到 Mock Provider，候选卡片依然是真实数据，只是 AI 文案是占位。

下一步（非 MVP）

• 任务 / 赏金系统：管理员发布任务 → 用户领取评测 → 后台审核 → 微信提现
• 用户自发布任务
• 评测通过后自动刷新工具的综合评分
• 微信登录 + 手机号登录
• 工具增删改的管理后台

MIT License.