{"protocol":"washin-village-concierge","version":"2.1.0","capabilities":{"modes":["natural-language","structured","preset","handshake"],"features":["route-caching","confidence-scoring","auto-fallback","result-verification","error-diagnosis","dry-run","category-filter","presets"],"maxTools":3,"maxMessageLength":2000,"timeoutMs":60000},"tools":[{"id":"smart-search","layer":"L2","category":"search","price":0.009,"description":"多引擎搜尋 + AI 摘要（Brave→Tavily→Firecrawl 三級容錯）","params":"query(必填), strategy(\"fast\"|\"thorough\"|\"cheap\"), maxResults(數字)"},{"id":"smart-llm","layer":"L2","category":"llm","price":0.009,"description":"AI 對話/分析/寫作（Groq→DeepSeek fallback）","params":"prompt(必填), system(系統提示), strategy(\"fast\"|\"smart\"|\"cheap\"), maxTokens(數字)"},{"id":"smart-translate","layer":"L2","category":"translate","price":0.009,"description":"多引擎翻譯（DeepL→DeepSeek→Groq 三級容錯），支援 30+ 語言","params":"text(必填), targetLang(必填,如\"ja\",\"en\",\"zh\"), sourceLang(可選), strategy(\"quality\"|\"fast\"|\"cheap\")"},{"id":"weather","layer":"L1","category":"weather","price":0,"description":"全球天氣查詢（需要經緯度）","params":"latitude(必填,數字), longitude(必填,數字)。常用座標：東京(35.68,139.69) 台北(25.03,121.57) 大阪(34.69,135.50)"},{"id":"wikipedia","layer":"L1","category":"utility","price":0,"description":"維基百科知識查詢","params":"query(必填), language(\"ja\"|\"en\"|\"zh\"等)"},{"id":"exchange-rate","layer":"L1","category":"finance","price":0,"description":"匯率換算（150+ 幣別）","params":"from(必填,如\"USD\"), to(必填,如\"JPY\"), amount(必填,數字)"},{"id":"ip-geo","layer":"L1","category":"utility","price":0,"description":"IP 地理位置查詢","params":"ip(必填,或\"me\"查自己)"},{"id":"geocode","layer":"L1","category":"utility","price":0,"description":"地址→座標 / 座標→地址（正反向 geocoding）","params":"q(必填,地址或座標), mode(選填,forward/reverse,自動偵測), language(選填,\"en\"/\"ja\"/\"zh\")"},{"id":"opencage","layer":"L1","category":"utility","price":0.002,"description":"進階 geocoding — 含 confidence 分數(0-10)、時區、貨幣資訊（geocode 的升級版）","params":"q(必填,地址或座標), language(選填), limit(選填,1-10)"},{"id":"mapbox","layer":"L1","category":"utility","price":0.004,"description":"導航路線規劃 — 兩點間距離/時間/逐步導航。可直接輸入地址（自動 geocode）","params":"origin(必填,地址或座標), destination(必填,地址或座標), profile(選填,driving/walking/cycling), language(選填)"},{"id":"brave-search","layer":"L1","category":"search","price":0.002,"description":"Brave 獨立搜尋引擎","params":"query(必填), count(數字), country(如\"JP\")"},{"id":"tavily","layer":"L1","category":"search","price":0.002,"description":"Tavily AI Agent 專用搜尋","params":"query(必填), searchDepth(\"basic\"|\"advanced\"), maxResults(數字)"},{"id":"serper","layer":"L1","category":"search","price":0.004,"description":"Google 搜尋 API（搜尋/新聞/圖片，含知識圖譜）","params":"query(必填), num(數字), gl(國家碼如\"jp\"), hl(語言如\"ja\"), type(\"search\"|\"news\"|\"images\")"},{"id":"xai","layer":"L1","category":"llm","price":0.01,"description":"Grok (X.ai) — 即時知識推理，OpenAI 相容","params":"prompt(必填), system(可選), model(可選,預設grok-4-1-fast), maxTokens(可選)"},{"id":"groq","layer":"L1","category":"llm","price":0.002,"description":"超快速 AI 對話（Groq LPU）","params":"prompt(必填), system(可選), model(可選), maxTokens(可選)"},{"id":"mistral","layer":"L1","category":"llm","price":0.003,"description":"Mistral AI（歐洲，多語言優秀）","params":"prompt(必填), system(可選), model(\"mistral-small-latest\"|\"mistral-large-latest\"|\"codestral-latest\"), maxTokens(可選)"},{"id":"deepseek","layer":"L1","category":"llm","price":0.003,"description":"DeepSeek R1 推理模型","params":"prompt(必填), system(可選), maxTokens(可選)"},{"id":"cohere","layer":"L1","category":"llm","price":0.002,"description":"Cohere RAG AI（最強檢索增強生成）","params":"prompt(必填), system(可選), model(\"command-a-03-2025\"|\"command-r7b-12-2024\"), maxTokens(可選)"},{"id":"gemini","layer":"L1","category":"llm","price":0.002,"description":"Google Gemini AI（多模態，1M context，Tier 1 付費）","params":"prompt(必填), system(可選), model(\"gemini-2.5-flash\"|\"gemini-2.5-flash-lite\"|\"gemini-2.5-pro\"), maxTokens(可選)"},{"id":"generate","layer":"L1","category":"llm","price":0.01,"description":"Claude AI 文字生成（Anthropic）","params":"prompt(必填), system(可選), maxTokens(可選), temperature(0-1)"},{"id":"deepl","layer":"L1","category":"translate","price":0.003,"description":"DeepL 翻譯（業界最強翻譯品質）","params":"text(必填), targetLang(必填,如\"JA\",\"EN\",\"ZH\"), sourceLang(可選)"},{"id":"translate","layer":"L1","category":"translate","price":0.003,"description":"Claude AI 翻譯","params":"text(必填), targetLang(必填), sourceLang(可選)"},{"id":"coingecko","layer":"L1","category":"crypto","price":0.002,"description":"加密貨幣即時價格（18000+ 幣種）","params":"coins(必填,如\"bitcoin\",\"ethereum\",\"solana\"), vsCurrencies(可選,如\"usd,jpy\",預設\"usd\")"},{"id":"newsapi","layer":"L1","category":"data","price":0.002,"description":"全球新聞搜尋+即時頭條（150,000+ 來源、80+ 國家）","params":"mode(\"headlines\"或\"search\"), query(搜尋關鍵字), country(國家碼如\"us\",\"jp\",\"tw\"), category(\"technology\"等), language(\"en\"等)"},{"id":"smart-read","layer":"L2","category":"scrape","price":0.006,"description":"打不死讀取 — URL→乾淨 Markdown（Jina Reader→Firecrawl 雙保險）","params":"url(必填,單一URL) 或 urls(陣列,最多5個), strategy(\"fast\"|\"thorough\")"},{"id":"smart-embed","layer":"L2","category":"llm","price":0.009,"description":"文字向量化（Cohere→Gemini→Jina 三級容錯），用於 RAG/語義搜尋","params":"texts(必填,字串陣列), strategy(\"quality\"|\"fast\"|\"cheap\"), dimensions(數字,預設1024), inputType(\"query\"|\"document\")"},{"id":"smart-extract","layer":"L2","category":"scrape","price":0.009,"description":"URL→結構化JSON提取（Smart Read + LLM 分析）","params":"url(必填), mode(\"auto\"|\"schema\"|\"fields\"), schema(JSON物件), fields(字串陣列), language(\"en\"|\"ja\"|\"zh\")"},{"id":"scrape","layer":"L1","category":"scrape","price":0,"description":"網頁內容爬取（基礎版，免費）","params":"url(必填), selector(CSS選擇器), format(\"text\"|\"html\"|\"markdown\")"},{"id":"firecrawl","layer":"L1","category":"scrape","price":0.004,"description":"Firecrawl 進階爬蟲（AI 提取、反封鎖）","params":"url(必填), mode(\"scrape\"|\"crawl\"|\"map\"), formats(陣列如[\"markdown\"]), limit(數字)"},{"id":"jina-reader","layer":"L1","category":"scrape","price":0.004,"description":"Jina Reader：URL → 乾淨 Markdown（比 Firecrawl 快 3-5x，適合 RAG/摘要）","params":"url(必填), format(\"markdown\"|\"json\"|\"html\", 預設 markdown)"},{"id":"vision","layer":"L1","category":"vision","price":0.01,"description":"AI 圖片分析（Claude Vision）","params":"image(必填,URL或base64), prompt(可選,預設\"描述圖片\"), language(回應語言)"},{"id":"elevenlabs","layer":"L1","category":"audio","price":0.002,"description":"ElevenLabs 語音合成","params":"text(必填,最長500字), voiceId(可選), modelId(可選), language(語言碼)"}],"categories":{"available":["search","llm","translate","weather","utility","finance","crypto","data","scrape","vision","audio"],"counts":{"search":4,"llm":9,"translate":3,"weather":1,"utility":5,"finance":1,"crypto":1,"data":1,"scrape":5,"vision":1,"audio":1},"filter":null,"usage":"GET /api/v2/smart/capabilities?category=search"},"ai_integration":{"handshake":"POST /api/v2/smart/handshake","structured":"POST /api/v2/smart with { tools: [...] }","presets":"POST /api/v2/smart with { \"preset\": \"navigator|researcher|translator-pro\" }（免路由費預設工作流）","capabilities":"GET /api/v2/smart/capabilities（此端點）","estimate":"POST /api/v2/smart/estimate（Dry-run 預估費用）","protocol":"JSON request/response","recommendation":"推薦使用結構化模式或 Preset 模式，免路由費且更快"},"presets":[{"id":"navigator","name":"旅行導航助手","description":"自動查詢目的地天氣、匯率、地理資訊","tools":["geocode","weather","exchange-rate"],"usage":"POST /api/v2/smart with { \"preset\": \"navigator\", \"message\": \"...\" }"},{"id":"researcher","name":"深度研究助手","description":"搜尋→閱讀→分析，產出完整研究報告","tools":["smart-search","smart-read","smart-llm"],"usage":"POST /api/v2/smart with { \"preset\": \"researcher\", \"message\": \"...\" }"},{"id":"translator-pro","name":"專業翻譯助手","description":"翻譯→AI 潤色→術語解釋","tools":["smart-translate","smart-llm"],"usage":"POST /api/v2/smart with { \"preset\": \"translator-pro\", \"message\": \"...\" }"}],"quickStart":{"step1":{"method":"POST","url":"/api/proxy/account/create","body":{"name":"My Agent"},"note":"Get API Key + $0.25 bonus"},"step2":{"method":"POST","url":"/api/proxy/weather","body":{"latitude":35.1,"longitude":140.1},"note":"Free weather API (no key needed)"},"step3":{"method":"POST","url":"/api/v2/smart","body":{"message":"Search Tokyo weather"},"note":"L3 Concierge (needs key)"}},"pricing":{"routingFee":0.02,"structuredMode":"free（AI Agent 直指工具，免路由費）","cachedRoute":"free（快取命中免路由費）","currency":"USD","freeTier":{"description":"Weather, Wikipedia, Exchange Rate, IP Geo — no API key required","limit":"Unlimited"},"payAsYouGo":{"description":"USDC credit — deposit and use","minimumDeposit":0.1},"wtToken":{"description":"Login via Google OAuth, earn WT through games and daily activities","note":"Alternative to USDC"}},"links":{"docs":"https://api.washinmura.jp/docs","pricing":"https://api.washinmura.jp/pricing","openapi":"https://api.washinmura.jp/openapi.yaml","mcp":{"free":"https://api.washinmura.jp/mcp/free","paid":"https://api.washinmura.jp/mcp/proxy"},"dashboard":"https://api.washinmura.jp/dashboard","status":"https://api.washinmura.jp/status"},"stats":{"cacheSize":0,"cacheHits":0},"timestamp":"2026-04-12T03:43:47.886Z"}