Decide

🚀 decide.fyi

Decide.fyi 為美國消費者提供確定性的訂閱決策公證服務，幫助用戶快速、準確地瞭解訂閱服務的退款、取消、退貨和試用等相關政策。

🚀 快速開始

一鍵安裝

點擊按鈕將安裝 Refund Notary 服務器。若要添加全部 4 個服務器，請使用 下方的 JSON 配置。

通過 MCP 連接（Claude 桌面版 / Windsurf / 其他客戶端）

{
  "mcpServers": {
    "refund-decide": { "url": "https://refund.decide.fyi/api/mcp" },
    "cancel-decide": { "url": "https://cancel.decide.fyi/api/mcp" },
    "return-decide": { "url": "https://return.decide.fyi/api/mcp" },
    "trial-decide":  { "url": "https://trial.decide.fyi/api/mcp" }
  }
}

REST API

# 退款資格檢查
curl -X POST https://refund.decide.fyi/api/v1/refund/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

# 取消訂閱懲罰檢查
curl -X POST https://cancel.decide.fyi/api/v1/cancel/penalty \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

# 退貨資格檢查
curl -X POST https://return.decide.fyi/api/v1/return/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

# 試用條款檢查
curl -X POST https://trial.decide.fyi/api/v1/trial/terms \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

本地開發檢查

啟動本地開發服務器：

npx vercel dev

在另一個終端中：

# 處理程序級冒煙測試（無需運行服務器）
npm run smoke

# MCP 端點檢查（需要在本地主機:3000 上運行 vercel dev）
npm run mcp:check

# 端到端工作流測試（示例 -> 結果）
npm run workflow:test

✨ 主要特性

• 多服務支持：提供退款、取消訂閱、退貨和試用條款的檢查服務。
• 多客戶端兼容：支持多種客戶端，如 Cursor、VS Code、Claude、ChatGPT 等。
• 數據即時性：每日自動檢查供應商政策頁面，確保數據新鮮度。
• 架構優勢：無狀態、確定性、版本化規則、每日監控、無服務器、零依賴。

📦 安裝指南

一鍵安裝

可通過以下按鈕一鍵安裝 Refund Notary 服務器：

若要添加全部 4 個服務器，請使用 下方的 JSON 配置。

通過 MCP 連接

使用以下 JSON 配置連接到所有服務：

{
  "mcpServers": {
    "refund-decide": { "url": "https://refund.decide.fyi/api/mcp" },
    "cancel-decide": { "url": "https://cancel.decide.fyi/api/mcp" },
    "return-decide": { "url": "https://return.decide.fyi/api/mcp" },
    "trial-decide":  { "url": "https://trial.decide.fyi/api/mcp" }
  }
}

💻 使用示例

基礎用法 - REST API

退款資格檢查

curl -X POST https://refund.decide.fyi/api/v1/refund/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

取消訂閱懲罰檢查

curl -X POST https://cancel.decide.fyi/api/v1/cancel/penalty \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

退貨資格檢查

curl -X POST https://return.decide.fyi/api/v1/return/eligibility \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'

試用條款檢查

curl -X POST https://trial.decide.fyi/api/v1/trial/terms \
  -H "Content-Type: application/json" \
  -d '{"vendor":"adobe","region":"US","plan":"individual"}'

高級用法 - Zendesk 工作流編排

當你希望一個請求返回以下內容時，可以使用工作流端點：

• 來自 /api/decide 的決策分類 (yes | no | tie)
• 相關公證端點的政策結果
• 推薦的 Zendesk 操作 + 標籤 + 包含 request_id 的私有備註

端點

• POST https://refund.decide.fyi/api/v1/workflows/zendesk/refund
• POST https://cancel.decide.fyi/api/v1/workflows/zendesk/cancel
• POST https://return.decide.fyi/api/v1/workflows/zendesk/return
• POST https://trial.decide.fyi/api/v1/workflows/zendesk/trial

請求示例

{
  "ticket_id": "ZD-9001",
  "workflow_type": "refund",
  "question": "Should this Adobe annual plan refund request proceed under policy?",
  "vendor": "adobe",
  "region": "US",
  "plan": "individual",
  "days_since_purchase": 5
}

對於 refund 和 return 請求，請包含 days_since_purchase。

確定性測試模式

在測試和持續集成期間，可以設置 decision_override 來繞過模型分類：

{
  "decision_override": "yes"
}

響應示例

{
  "ok": true,
  "flow": "zendesk_refund_v1",
  "ticket_id": "ZD-9001",
  "decision": { "c": "yes", "request_id": "req_123" },
  "policy": { "verdict": "ALLOWED", "code": "WITHIN_WINDOW" },
  "action": {
    "type": "approve_refund",
    "zendesk_tags": ["decide", "decide_yes", "refund_allowed"]
  }
}

📚 詳細文檔

MCP 服務器信息

服務器	域名	工具	裁決結果
Refund Notary	refund.decide.fyi	refund_eligibility	ALLOWED / DENIED / UNKNOWN
Cancel Notary	cancel.decide.fyi	cancellation_penalty	FREE_CANCEL / PENALTY / LOCKED / UNKNOWN
Return Notary	return.decide.fyi	return_eligibility	RETURNABLE / EXPIRED / NON_RETURNABLE / UNKNOWN
Trial Notary	trial.decide.fyi	trial_terms	TRIAL_AVAILABLE / NO_TRIAL / UNKNOWN

所有服務器支持 100 個供應商，服務區域為美國，僅支持個人計劃，無狀態，無需認證，每分鐘 100 個請求。

支持的供應商

供應商	標識符	退款	取消	退貨	試用
1Password	1password	無退款	免費	無退貨	14 天
Adobe	adobe	14 天	ETF	14 天全額退款	7 天
Amazon Prime	amazon_prime	3 天	免費	3 天全額退款	30 天
Apple App Store	apple_app_store	14 天	免費	14 天全額退款	-
Apple Music	apple_music	無退款	免費	無退貨	30 天
Apple TV+	apple_tv_plus	無退款	免費	無退貨	7 天
Audible	audible	無退款	免費	無退貨	30 天
Bitwarden	bitwarden	30 天	免費	30 天全額退款	7 天
Bumble	bumble	無退款	免費	無退貨	7 天
Calm	calm	30 天	免費	30 天全額退款	7 天
Canva	canva	無退款	免費	無退貨	30 天
ChatGPT Plus	chatgpt_plus	無退款	免費	無退貨	-
Claude Pro	claude_pro	無退款	免費	無退貨	-
Coursera Plus	coursera_plus	14 天	免費	14 天全額退款	7 天
Crunchyroll	crunchyroll	無退款	免費	無退貨	7 天
Deezer	deezer	無退款	免費	無退貨	30 天
Disney+	disney_plus	無退款	免費	無退貨	-
DoorDash DashPass	doordash_dashpass	無退款	免費	無退貨	30 天
Dropbox (US)	dropbox_us	無退款	免費	無退貨	30 天
Duolingo	duolingo	無退款	免費	無退貨	14 天
Evernote	evernote	20 天	免費	20 天全額退款	14 天
ExpressVPN	expressvpn	30 天	免費	30 天全額退款	7 天
Figma	figma	無退款	免費	無退貨	30 天
Fubo TV	fubo_tv	無退款	免費	無退貨	7 天
GitHub Pro	github_pro	無退款	免費	無退貨	-
Google Play	google_play	2 天	免費	2 天全額退款	-
Grammarly	grammarly	無退款	免費	無退貨	7 天
Headspace	headspace	無退款	免費	無退貨	7 天
HelloFresh	hellofresh	無退款	免費（提前 5 天通知）	無退貨	-
Hinge	hinge	無退款	免費	無退貨	7 天
Hulu	hulu	無退款	免費	無退貨	30 天
iCloud+	icloud_plus	14 天	免費	14 天全額退款	-
Instacart+	instacart_plus	5 天	免費	5 天全額退款	14 天
LinkedIn Premium	linkedin_premium	7 天	免費	7 天全額退款	30 天
MasterClass	masterclass	30 天	免費	30 天全額退款	-
Max (HBO)	max	無退款	免費	無退貨	-
Microsoft 365	microsoft_365	30 天	免費	30 天全額退款	30 天
Midjourney	midjourney	無退款	免費	無退貨	-
Netflix	netflix	無退款	免費	無退貨	-
Nintendo Switch Online	nintendo_switch_online	無退款	免費	無退貨	7 天
Noom	noom	14 天	免費	14 天全額退款	7 天
NordVPN	nordvpn	30 天	免費	30 天全額退款	7 天
Notion	notion	3 天	免費	3 天全額退款	-
Paramount+	paramount_plus	無退款	免費	無退貨	7 天
Peacock	peacock	無退款	免費	無退貨	7 天
Peloton	peloton	無退款	免費	無退貨	30 天
PlayStation Plus	playstation_plus	14 天	免費	14 天按比例退款	14 天
Scribd	scribd	30 天	免費	30 天全額退款	30 天
Shutterstock	shutterstock	無退款	ETF	無退貨	30 天
Slack	slack	無退款	免費	信用退款	90 天
Sling TV	sling_tv	無退款	免費	無退貨	-
Spotify	spotify	無退款	免費	無退貨	30 天
Squarespace	squarespace	14 天	免費	14 天全額退款	14 天
Strava	strava	14 天	免費	14 天全額退款	30 天
Surfshark	surfshark	30 天	免費	30 天全額退款	7 天
Tidal	tidal	無退款	免費	無退貨	30 天
Tinder	tinder	無退款	免費	無退貨	-
Todoist	todoist	30 天	免費	30 天全額退款	30 天
Twitch	twitch	無退款	免費	無退貨	-
Walmart+	walmart_plus	無退款	免費	無退貨	30 天
Wix	wix	14 天	免費	14 天全額退款	14 天
Xbox Game Pass	xbox_game_pass	30 天	免費	30 天全額退款	14 天
YouTube Premium	youtube_premium	無退款	免費	無退貨	30 天
Zoom	zoom	無退款	免費	無退貨	-

服務範圍：僅支持美國地區的個人計劃。

數據新鮮度

政策信息來源於供應商的官方文檔和服務條款。

• 每日自動檢查：GitHub Action 會在協調世界時 08:00 運行，對所有 4 項服務（退款、取消、退貨、試用）的供應商政策頁面進行哈希處理。如果頁面發生變化，將開啟一個問題進行審核。
• 政策源 URL 跟蹤：每個服務在 rules/ 目錄下都有自己的源文件，鏈接到官方政策頁面。
• 合規性導出：GET /api/compliance-export 返回跟蹤源、哈希值和待處理候選更改的 CSV 快照（?format=json 可獲取機器可讀輸出）。
• 規則版本化：每個規則文件都包含一個 rules_version 字段，用於檢測數據陳舊性。

免費 API（默認：無需認證）

所有 4 個政策服務器均可免費使用，無需認證，也無需 API 密鑰。 /api/decide 默認公開，可通過在服務器環境變量中設置 DECIDE_API_KEY 進行保護。 如果你在 decidesite 代理後面運行 decide 並使用動態客戶密鑰，還需設置：

• DECIDE_PROXY_SHARED_TOKEN：在 x-decide-proxy-token 頭中需要的共享密鑰，用於可信代理調用。
• DECIDE_API_KEY：可信代理轉發到上游的後端內部密鑰（建議保持後端私有）。

速率限制：每個 IP 每分鐘 100 個請求。

政策獲取鉤子（用於政策檢查器瀏覽器鉤子通道）

當直接獲取被阻止時，可以使用 POST /api/policy-fetch-hook 作為每日檢查器的獲取適配器。

請求體：

{
  "url": "https://example.com/policy",
  "vendor": "example_vendor",
  "policy_type": "refund",
  "timeout_ms": 18000
}

認證：

• Authorization: Bearer <POLICY_CHECK_BROWSER_HOOK_TOKEN> 或 x-hook-token: <token>

服務器環境變量：

• POLICY_CHECK_BROWSER_HOOK_TOKEN（端點認證必需）
• POLICY_FETCH_BROWSERLESS_TOKEN（可選；啟用無頭瀏覽器渲染優先）
• POLICY_FETCH_BROWSERLESS_CONTENT_URL（可選覆蓋；默認 https://chrome.browserless.io/content）
• POLICY_FETCH_ALLOWED_HOSTS（可選，逗號分隔的主機白名單）

檢查器（GitHub Actions，倉庫 decide）：

• 密鑰 POLICY_CHECK_BROWSER_HOOK_URL = 部署的端點 URL（例如：https://decide-1.vercel.app/api/policy-fetch-hook）
• 密鑰 POLICY_CHECK_BROWSER_HOOK_TOKEN = 與運行時環境相同的令牌
• 變量 POLICY_CHECK_FETCH_LANES_DEFAULT = browser_hook,direct,zendesk_api,mirror

如有疑問，請聯繫 decidefyi@gmail.com 或在 X 平臺上聯繫 @decidefyi。

鏈接

• 網站：https://decide.fyi
• 退款服務：https://refund.decide.fyi
• 取消訂閱服務：https://cancel.decide.fyi
• 退貨服務：https://return.decide.fyi
• 試用服務：https://trial.decide.fyi
• X/Twitter：@decidefyi
• MCP 規範：https://modelcontextprotocol.io

🔧 技術細節

架構特點

• 無狀態：無需數據庫、會話，無副作用。
• 確定性：相同輸入始終產生相同輸出。
• 規則版本化：規則文件包含版本信息，便於跟蹤更改。
• 每日監控：GitHub Action 每日檢查所有供應商政策頁面。
• 無服務器：運行在 Vercel 無服務器函數上。
• 零依賴：核心計算邏輯無外部依賴。
• 主機名路由：Vercel 中間件將子域名路由到正確的 MCP 端點。

侷限性

• 僅支持美國地區：目前僅支持美國區域。
• 僅支持個人計劃：暫不支持企業/商業計劃。
• 按自然日計算：時間窗口基於自然日，而非工作日。
• 靜態規則：未考慮促銷優惠或特殊情況。

📄 許可證

文檔未提及相關許可證信息。

📝 更新日誌

未發佈

• 新增：GET /api/compliance-export 端點，用於導出政策監控證據（默認 CSV 格式，可通過 ?format=json 獲取 JSON 格式）。
• 新增：合規性導出 JSON 和 CSV 路徑的冒煙測試覆蓋。

v1.2.1 (2026-02-08)

• 更改：子域名主頁現在顯示相關的公證卡片（退款/取消/退貨/試用）。
• 更改：server.json、MCP initialize 和 /.well-known/* 中的版本元數據保持一致。

v1.2.0 (2026-02-02)

• 新增：Cancel Notary MCP（cancel.decide.fyi）—— 取消訂閱懲罰檢查器。
• 新增：Return Notary MCP（return.decide.fyi）—— 退貨資格檢查器。
• 新增：Trial Notary MCP（trial.decide.fyi）—— 免費試用條款檢查器。
• 新增：基於主機名的中間件路由，適用於所有子域名。
• 新增：取消、退貨和試用政策的政策源文件和每日檢查。
• 新增：著陸頁上的人類/代理模式切換。
• 新增：包含所有 4 個服務器卡片的 MCP 目錄。
• 修復：每日政策檢查器：添加 contents:write 權限並修復 shell 邏輯。
• 修復：移除導致 404 錯誤的無效 Cloudflare 電子郵件解碼腳本。

v1.1.0 (2026-02-01)

• 新增：支持的供應商數量從 64 個擴展到 100 個。
• 新增：每日政策檢查 GitHub Action（協調世界時 08:00 定時執行）。
• 新增：rules/policy-sources.json 中跟蹤政策源 URL。
• 新增：MCP 供應商 enum 輸入模式，便於代理發現。
• 修復：Vercel 上的 ERR_IMPORT_ATTRIBUTE_MISSING 崩潰問題（Node 22 導入屬性）。

v1.0.0 (2026-01-15)

• 新增：初始版本，包含 REST API 和 MCP 服務器。
• 新增：支持 9 個供應商。

---

由 decide.fyi 團隊用心打造。