API 服務正常運行
中文手遊產業
語意搜尋 API
wechat-game-rag 是一個基於向量語意搜尋的 RAG API，收錄多個中國遊戲行業微信公眾號文章，讓你用自然語言查詢最新的市場趨勢、玩法分析與產業動態。
概覽
這個 API 的核心功能是：將數千篇中文手遊媒體文章切段（chunk）並向量化，讓你用一句查詢詞找到語意最接近的內容片段，再自行整合成分析報告或競品資料。
Base URL
https://wechat-game-rag.liuava.workers.dev
所有請求都必須帶上
X-API-Key header。未帶 key 會回傳 401 Unauthorized。認證
使用 HTTP header 傳入 API Key。
| Header | 說明 |
|---|---|
X-API-Key |
你的 API 金鑰，每個請求都必須攜帶 |
展開範例程式碼 curl
curl 範例
curl -X POST "https://wechat-game-rag.liuava.workers.dev/search" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "背包like玩法趨勢", "top_k": 10}'
快速上手
📋 程式碼範例（curl / Python / JavaScript）
bash
# 查詢「肉鸽」相關的最新遊戲報導 curl -s -X POST \ "https://wechat-game-rag.liuava.workers.dev/search" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "肉鸽roguelike手游新品", "top_k": 10, "date_from": "2026-01-01" }'
python
import requests API_KEY = "YOUR_API_KEY" BASE_URL = "https://wechat-game-rag.liuava.workers.dev" def search(query, top_k=10, source=None, date_from=None, date_to=None): payload = {"query": query, "top_k": top_k} if source: payload["source"] = source if date_from: payload["date_from"] = date_from if date_to: payload["date_to"] = date_to resp = requests.post( f"{BASE_URL}/search", headers={"X-API-Key": API_KEY}, json=payload ) return resp.json() # 範例：查 Gamelook 關於割草遊戲的報導 data = search("割草like爆款分析", top_k=5, source="Gamelook") for r in data["results"]: print(f"[{r['date']}] {r['title']}") print(f" 相似度: {r['similarity']:.3f}") print(f" {r['text'][:120]}...") print()
javascript
const API_KEY = "YOUR_API_KEY"; const BASE_URL = "https://wechat-game-rag.liuava.workers.dev"; async function search(query, options = {}) { const { top_k = 10, source, date_from, date_to } = options; const payload = { query, top_k, ...source && { source }, ...date_from && { date_from }, ...date_to && { date_to } }; const res = await fetch(`${BASE_URL}/search`, { method: "POST", headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" }, body: JSON.stringify(payload) }); return res.json(); } // 範例：查詢出海市場分析 const data = await search("手游出海東南亞市場", { top_k: 8, date_from: "2025-06-01" }); data.results.forEach(r => { console.log(`[${r.date}] ${r.source} - ${r.title}`); });
端點：GET /health
GET
/health
服務健康檢查
不需要 API Key。確認服務是否正常運行。
展開 Response 格式 JSON
response 200
{
"ok": true,
"time": "2026-05-07T03:35:33.190Z"
}
端點：POST /search
POST
/search
語意搜尋主要端點
輸入自然語言查詢詞，回傳語意最接近的文章 chunk 列表，依相似度排序。
Request Body 參數
| 參數 | 類型 | 說明 | 預設 |
|---|---|---|---|
query 必填 |
string | 搜尋關鍵詞或句子，支援中英文 | — |
top_k 選填 |
number | 回傳筆數，上限 20，超過自動 cap。也可用 limit 別名 |
5 |
source 選填 |
string | 指定來源媒體，如 "Gamelook"。不填則搜全庫 |
null |
date_from 選填 |
string | 文章日期下限，格式 YYYY-MM-DD |
null |
date_to 選填 |
string | 文章日期上限，格式 YYYY-MM-DD |
null |
Response 結構
展開 Response 格式 JSON
response 200
{
"query": "肉鸽roguelike", // 你傳入的查詢詞
"top_k": 10, // 實際使用的 top_k
"filters": {
"source": null, // 套用的來源過濾
"date_from": null, // 套用的日期起始
"date_to": null // 套用的日期結束
},
"results": [
{
"source": "羅斯基", // 媒體名稱
"title": "肉鸽游戏市场分析...",// 文章標題
"date": "2025-04-14", // 發布日期 YYYY-MM-DD
"chunk_idx": 0, // 第幾個段落（從 0 開始）
"text": "肉鸽游戏的核心特点...",// 文章段落原文
"similarity": 0.554 // 語意相似度（0~1，越高越相關）
}
// ... 更多結果
]
}
錯誤回應
| HTTP 狀態 | 說明 |
|---|---|
401 |
缺少或無效的 API Key |
404 |
端點不存在 |
500 / search failed |
後端 DB 查詢逾時（statement timeout）。通常發生在未帶 top_k 時，建議一律帶 top_k |
資料來源
API 收錄以下 8 個中國遊戲行業媒體的微信公眾號文章，各有不同的報導角度。
Gamelook
產業深度分析、財報解讀、大廠動向、市場報告
羅斯基
玩法分類解析、市場趨勢觀察、爆款拆解
遊戲茶館
中文輿情評論、業界觀點、深度評論
新遊觀察
新遊速報、玩法 Demo 快評、每期新品彙整
GAME 游意思
週更新遊評分、玩法有趣性分析（個人視角）
急速行走的小U盤
IAA 原型產品快評、獨立遊戲觀察
王董的新遊戲
海外市場分析、出海策略、商業化觀點
廣大大出海筆記
廣告素材分析、出海數據、買量趨勢
使用
"source": "媒體名稱" 可以精確過濾到特定媒體的文章。媒體名稱需完全匹配，例如 "Gamelook"（注意大小寫）。資料覆蓋範圍
最早資料
2025/01
最早收錄文章約為 2025 年 1 月
最新資料
~持續更新
最新收錄至 2026 年 4 月（接近即時）
來源媒體
8+
主要中文遊戲媒體公眾號
時間軸
2025/01
資料起點
資料起點
2025/07
中期豐富
中期豐富
2026/04
最新收錄
最新收錄
資料以文章 chunk（段落）形式儲存，你拿到的是部分段落，不是完整文章。同一篇文章可能出現多個
chunk_idx 不同的結果。適用場景
✅ 可以做到
- 查詢特定遊戲/玩法類型的中文業界評論與分析
- 搜集競品遊戲的輿情報導（玩法、商業化、數據）
- 了解特定時間段的市場熱點（搭配 date_from/date_to）
- 對照特定媒體對某款遊戲的看法（搭配 source 過濾）
- 快速找到「某個玩法最近有哪些新品」
- 查詢廠商出海策略、買量趨勢等行業動態
- 為競品報告補充中文市場視角與評論素材
❌ 不適合做
- 當全文搜尋用（只有片段，不是完整文章）
- 取得「所有關於 X 的完整報導」（無法分頁/全掃）
- 用英文遊戲名搜中文庫（容易漏，建議用中文查詢）
- 即時數據查詢（流水、排名、下載量）
- 查詢 2025 年以前的歷史資料
- 列出某媒體的所有文章（無 browse 功能）
限制說明
最大回傳筆數
20
top_k 最大值，超過自動 cap
無分頁
—
沒有 offset/page，只能取前 N 筆
相似度範圍
0.25~0.55
典型返回值，低分結果相關性弱
逾時風險
⚠️
不帶 top_k 容易 timeout，務必帶上
重要：一定要帶 top_k。 未帶 top_k 的請求偶爾會觸發後端資料庫的 statement timeout，回傳
{"error":"search failed","detail":"canceling statement due to statement timeout"}。建議每個請求都明確設定 top_k（如 10 或 20）。Similarity 分數怎麼解讀： 0.5 以上代表高度相關；0.3~0.5 為中等相關；0.3 以下可能只是背景噪音。建議在後處理時加個 similarity 門檻過濾（如 >= 0.35）。
完整範例
範例 1 — 查詢近期背包 like 玩法分析
展開程式碼 curl
request
curl -X POST "https://wechat-game-rag.liuava.workers.dev/search" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "背包like玩法爆款分析", "top_k": 10, "date_from": "2025-06-01" }'
範例 2 — 只看 Gamelook 的遊戲出海報導
展開程式碼 curl
request
curl -X POST "https://wechat-game-rag.liuava.workers.dev/search" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "手游出海东南亚市场", "top_k": 5, "source": "Gamelook", "date_from": "2026-01-01" }'
範例 3 — Python 完整整合腳本（含相似度過濾）
展開程式碼 Python
python
import requests API_KEY = "YOUR_API_KEY" BASE_URL = "https://wechat-game-rag.liuava.workers.dev" def search_game_news(query, top_k=20, min_similarity=0.35, **filters): """查詢中文手遊新聞，自動過濾低相似度結果""" resp = requests.post( f"{BASE_URL}/search", headers={"X-API-Key": API_KEY}, json={"query": query, "top_k": top_k, **filters}, timeout=15 ) data = resp.json() if "error" in data: raise RuntimeError(f"Search failed: {data['error']}") # 過濾低相似度 results = [r for r in data["results"] if r["similarity"] >= min_similarity] return results # 使用範例 results = search_game_news( "割草like吸血鬼幸存者海外爆款", top_k=15, min_similarity=0.38, date_from="2025-01-01" ) for r in results: print(f"📰 [{r['date']}] {r['source']}") print(f" {r['title']}") print(f" 相似度: {r['similarity']:.3f} | Chunk #{r['chunk_idx']}") print(f" {r['text'][:200]}...") print()
🔍 真實搜尋示範
LIVE DEMO
查詢關鍵詞
合成塔防
top_k
20
命中筆數
20 筆
相似度範圍
0.41 – 0.49
| # | 日期 | 來源 | 文章標題 | 相似度 |
|---|---|---|---|---|
| 1 | 2026-03-17 | 急速行走的小U盤 | 这款LowPoly的建造塔防有SLG的潜质呀！ | 0.485 |
| 2 | 2025-07-22 | 羅斯基 | 塔防赛道迎来强力竞争者！这家成立11年的公司开始转型IAA了？ | 0.474 |
| 3 | 2025-12-19 | 急速行走的小U盤 | 竞技塔防新原型！融合了合成玩法体验如何？《Slime Clash》 | 0.451 |
| 4 | 2026-01-16 | 急速行走的小U盤 | 谁说点点只做SLG？来看看点点家这款塔防产品吧！ | 0.443 |
| 5 | 2026-01-20 | 急速行走的小U盤 | 塔防融合新思路！连线+召唤融合新体验！《一笔输出》 | 0.435 |
| 6 | 2025-10-20 | 急速行走的小U盤 | 塔防新原型！《王者围城》打造弹珠+塔防融合新体验！ | 0.427 |
| 7 | 2026-04-23 | 急速行走的小U盤 | 潜水员戴夫+守护塔防！这个产品有点意思！《无路可逃》 | 0.418 |
| 8 | 2026-03-02 | 急速行走的小U盤 | 对冲塔防新体验！国王排名IP+大梦养成的全新组合！ | 0.409 |
| 12 | 2025-01-15 | 羅斯基 | 2025年的塔防TD赛道，正在进入2.0时代 | 0.396 |
| 17 | 2024-12-25 | 羅斯基 | 合成塔防玩法成趋势？从《保卫向日葵》看新赛道机会 | 0.371 |
共 20 筆結果，表格顯示代表性 10 筆（含全部 3 篇羅斯基文章）
📄 高價值文章摘要（羅斯基 × 合成塔防主題）
本文以《保卫向日葵》為切入點，探討「合成 × 塔防」這個新興融合賽道。文章指出，合成玩法（Merge/合成二合一）近年已被廣泛嵌入多種品類，而與塔防結合後能為玩家提供「部署前的決策層」，使傳統塔防不再只是擺好炮台等待，而是增加前置資源管理的樂趣。
《保卫向日葵》以植物大戰殭屍系 IP 為外衣，採用合成升級塔防單位的核心循環：玩家先在網格上合成植物角色到足夠等級，再出陣對抗怪物波次。這種「合成即升級、升級即策略」的設計讓玩家有更強的掌控感，有別於傳統點選升級。
文章結論認為，合成塔防是一條尚未被頭部產品壟斷的藍海，具備差異化立項價值，尤其在輕度休閒市場（IAA 模式）仍有大量空間可挖掘。
合成塔防
保卫向日葵
IAA
藍海賽道
本文從宏觀賽道視角回顧 2024 年塔防品類的演進，並提出「塔防 2.0」的概念：第一代塔防依賴純路徑防禦（如植物大戰殭屍），而第二代塔防以「玩法融合」為核心競爭力——roguelike、合成、背包、對沖對戰等機制被大量嫁接進來，催生了一批新爆款。
文章梳理了 2024 年多款標誌性產品：靶心 like（放置防線型）、對沖塔防（PvP 形式）、合成塔防等子賽道各自的商業表現。作者認為 2025 年塔防賽道的門檻正在提高——光靠單一融合創新已不夠，需要在美術表現、IP 包裝或長線養成上擇一深化，才能脫穎而出。
對研發團隊的建議是：避免做「融合形式」雷同的跟風品，著重打磨差異化「體感」，即操作反饋和情緒設計。
塔防2.0
賽道洞察
roguelike融合
2025趨勢
💡 關於文章連結：微信公眾號文章本身無法直接外連，但知名媒體（羅斯基、Gamelook 等）通常會同步發佈至知乎、騰訊新聞、白鯨出海等平台。可透過文章標題在各平台搜尋取得外部連結。
範例 4 — 多關鍵詞組合查詢（競品分析流程）
展開程式碼 Python
python
# 針對一款競品遊戲，從多角度搜集輿情 queries = [ "向僵尸开炮 BangBang Survivor", "向僵尸开炮 商业化 流水", "弹射like 僵尸割草 新品", ] all_results = [] seen_titles = set() for q in queries: hits = search_game_news(q, top_k=10, min_similarity=0.35) for r in hits: if r["title"] not in seen_titles: seen_titles.add(r["title"]) all_results.append(r) # 按日期排序，最新在前 all_results.sort(key=lambda x: x["date"], reverse=True) print(f"共找到 {len(all_results)} 筆不重複報導")