TRY TRY LOOK Skill A: 市場研究與潛客開發

by: Big Sking Chill

Skill A 是一個全自動化的市場研究與潛客開發解決方案。只需輸入品牌 URL 和目標市場，系統將自動執行完整的市場分析、SEO 研究、ICP 推導和潛客開發，生成詳細的分析報告和 30/60/90 天行動計劃。

#Marketing

Valoración

Se necesitan más valoraciones

Vendidos

Cómo se usa

Ejecutar en Capafy

También en aplicaciones externas

Proporcionado por el publisher

GPT-5.6 Terra

name: market-research-lead-development
description: Automated market research, SEO analysis, ICP definition, and lead generation with one-click input and AI Agent workflow integration.
author: Big Sking Chill
version: 1.0.0
category: Market Research
tags:

automation
ai-agent
capafy-skill

Skill A: Market Research & Lead Development

Skill ID: skill-a-market-research
Version: 1.0.0
Status: Production Ready
Last Updated: 2026-07-17

Overview

Core Features

1. Market Analysis

市場規模與增長率分析
行業趨勢識別
市場機會評估
可信度評分

2. Competitive Analysis

競品定位分析
優勢與劣勢對比
市場份額估算
競品策略分析

3. SEO Analysis

搜尋意圖分析
內容機會識別
內容缺口分析
關鍵字研究

4. ICP Derivation

理想客戶輪廓定義
公司規模與收入範圍
行業分類
痛點與購買信號識別

5. Lead Generation

潛客識別與評分
決策者識別
外展角度定義
優先級排序

6. Report Generation

完整分析報告
執行摘要
30/60/90 天計劃
HTML/Markdown 匯出

Input Parameters

{
  "brand_url": "https://example.com",
  "target_market": "台灣 SaaS",
  "mode": "fast",
  "research_objectives": ["comprehensive"],
  "competitor_urls": ["https://competitor1.com"],
  "target_keywords": ["project management", "SaaS"]
}

Required Parameters

brand_url (string): 品牌網站 URL
target_market (string): 目標市場描述

Optional Parameters

mode (string): 研究模式 - fast (15-30 分鐘) 或 deep (1-3 小時)，預設：fast
research_objectives (array): 研究目標，預設：["comprehensive"]
competitor_urls (array): 競品 URL 列表
target_keywords (array): 目標關鍵字列表

Output

{
  "job_id": "job_20260717_001",
  "status": "COMPLETED",
  "report": {
    "executive_summary": "市場機會概述...",
    "market_analysis": {...},
    "seo_analysis": {...},
    "ideal_customer_profile": {...},
    "prospect_list": [...],
    "action_plan": {...}
  }
}

Execution Time

Mode	Duration	Data Points	Accuracy
Fast	15-30 分鐘	50+	95%+
Deep	1-3 小時	100+	98%+

Supported Data Sources

Google News
Google Trends
Industry Reports
Company Websites
LinkedIn Public Data (when available)

Quality Metrics

Traceability: > 95%
Accuracy: > 95%
Credibility Score: 0.80+
Report Quality Score: 0.85+

Integration

With Skill B

Skill A 的輸出可直接作為 Skill B（多平台內容生成）的輸入，實現完整的市場研究到內容生成的自動化工作流。

Installation

# 解壓縮
unzip skill_a_package.zip
cd skill_a_package

# 安裝依賴
pip install -r requirements.txt

# 配置環境變數
cp .env.example .env
export GOOGLE_API_KEY=your_key

# 執行測試
pytest tests/

# 啟動
python3 -m uvicorn app:app --host 0.0.0.0 --port 8000

API Endpoints

Run Analysis

POST /skill-a/run

Check Status

GET /skill-a/status/{job_id}

Get Results

GET /skill-a/result/{job_id}

Documentation

README: README_SKILL_A.md
API Spec: API_SKILL_A.md
Deployment: DEPLOYMENT.md
Tests: tests/test_skill_a.py

Support

Email: [email protected]
Documentation: See included docs
Issues: Report via GitHub Issues

Version History

v1.0.0 (2026-07-17)

Initial release
Complete market research functionality
SEO analysis
ICP derivation
Lead generation
Report generation with 30/60/90 plan
26 test cases with 85%+ coverage

License

MIT License

Author

Big Sking Chill Development Team

Status: ✅ Production Ready
Last Updated: 2026-07-17

法律合規警示 - 用戶必讀

版本: 1.0.0
生效日期: 2026-07-20
適用範圍: 全球

⚠️ 重要法律聲明

本 Skill（技能）由 Capafy AI 提供，用於自動化市場研究、內容生成和媒體資產製作。使用本 Skill 即表示您同意以下所有條款和條件。

1. 隱私和數據保護

1.1 個人數據處理

本 Skill 在運作過程中可能會接觸到個人信息。我們採取以下措施保護隱私：

自動遮蔽: 所有個人信息（電話號碼、電子郵件、身份證號、信用卡號等）將被自動檢測和遮蔽
不存儲: 個人信息不會被存儲或用於任何其他目的
加密傳輸: 所有數據傳輸均使用加密連接
審計日誌: 所有數據處理活動都有審計日誌記錄

1.2 遮蔽的個人信息類型

以下類型的個人信息將被自動遮蔽：

信息類型	示例	遮蔽方式
電話號碼	0912-345-678	091-**-678
電子郵件	[email protected]	jo***@example.com
身份證號	A123456789	A1****89
信用卡號	1234-5678-9012-3456	**--**-3456
住址	123 Main Street	[ADDRESS_REDACTED]
護照號	AB123456	AB****56
駕照號	DL123456	DL****56
銀行帳號	12345678901234	****1234
IP 地址	192.168.1.1	192.*..**

1.3 GDPR 和其他隱私法規

本 Skill 符合以下隱私法規：

歐盟 GDPR (General Data Protection Regulation)
台灣個人資料保護法 (Personal Data Protection Act)
中國個人信息保護法 (Personal Information Protection Law)
美國 CCPA (California Consumer Privacy Act)
日本個人信息保護法 (Act on the Protection of Personal Information)
以及其他適用的全球隱私法規

2. 著作權和知識產權

2.1 禁止行為

本 Skill 嚴格禁止以下行為：

爬取受版權保護的內容
- 受版權保護的文章、書籍、論文
- 受版權保護的圖像、視頻、音樂
- 受版權保護的軟件代碼
侵犯商標權
- 未經授權使用他人商標
- 冒充他人品牌
侵犯專利權
- 未經授權複製受專利保護的技術
侵犯商業秘密
- 爬取或使用他人的商業秘密
- 未經授權訪問受限內容

2.2 著作權檢查機制

本 Skill 實施以下著作權保護機制：

自動檢測: 檢測內容中的版權符號（©、®、™）
域名檢查: 檢查是否來自受保護的域名（Getty Images、Shutterstock 等）
風險評分: 對每個內容進行著作權風險評分
自動阻止: 當風險評分超過 0.5 時，自動阻止爬取

2.3 合法使用

以下情況下可以使用本 Skill 爬取內容：

公開信息: 未受版權保護的公開信息
授權內容: 獲得版權所有者明確授權的內容
合理使用: 符合當地法律的合理使用（如教育、研究、評論）
開放許可: 使用 Creative Commons 或其他開放許可的內容

3. 速率限制和公平使用

3.1 速率限制

本 Skill 實施基於 RPS（每秒請求數）的速率限制，以確保公平使用和系統穩定性：

用戶類型	限制	說明
免費用戶	10 RPS	每秒最多 10 個請求
付費用戶	50 RPS	每秒最多 50 個請求
企業用戶	自定義	根據合同自定義

3.2 超限後果

如果超過速率限制：

第一次: 返回 429 Too Many Requests 錯誤，建議等待
多次違規: 帳戶可能被暫時或永久禁用
惡意行為: 可能面臨法律訴訟

3.3 公平使用政策

不得使用自動化工具規避速率限制
不得嘗試 DDoS 攻擊或其他惡意行為
不得將 API 密鑰分享給他人
不得用於非法目的

4. 禁止的使用場景

本 Skill 嚴格禁止用於以下目的：

4.1 非法活動

詐騙、欺詐或冒充
洗錢或資金來源不明
販毒或其他犯罪活動
恐怖融資
人口販運或強迫勞動

4.2 騷擾和暴力

騷擾、威脅或恐嚇他人
發送垃圾郵件或騷擾信息
網絡欺凌或騷擾
鼓勵暴力或自殘

4.3 歧視和仇恨

基於種族、膚色、民族、國籍、宗教、性別、性取向、殘疾或年齡的歧視
仇恨言論或仇恨犯罪
騷擾受保護群體

4.4 性剝削

兒童性虐待材料
性騷擾或性勒索
非法色情內容

4.5 其他非法用途

違反當地或國際法律
幫助他人進行非法活動
任何其他違法行為

5. 責任限制

5.1 免責聲明

Capafy AI 對以下情況不承擔責任：

用戶違反本協議條款
用戶使用本 Skill 進行非法活動
用戶因使用本 Skill 而遭受的任何損失或損害
第三方的行為或內容
系統中斷或服務不可用

5.2 用戶責任

您同意：

對您使用本 Skill 的所有行為負責
遵守所有適用的法律和法規
不侵犯他人的權利
賠償 Capafy AI 因您的違規行為而遭受的任何損失

6. 審計和監控

6.1 日誌記錄

所有使用本 Skill 的活動都會被記錄，包括：

請求時間和內容
用戶 ID 和 IP 地址
檢測到的隱私數據
著作權風險評分
速率限制違規

6.2 監控和執法

Capafy AI 保留以下權利：

監控本 Skill 的使用情況
調查可疑活動
暫停或終止違規用戶的訪問
向執法部門報告非法活動

7. 違規後果

7.1 警告

首次輕微違規時，我們將發出警告。

7.2 暫停

多次違規或嚴重違規時，帳戶可能被暫停 7-30 天。

7.3 終止

以下情況下帳戶將被永久終止：

重複違規
嚴重違規（如非法活動、著作權侵犯）
威脅或騷擾他人
嘗試規避安全措施

7.4 法律訴訟

對於嚴重違規，Capafy AI 保留追究法律責任的權利。

8. 隱私政策

8.1 數據收集

我們收集以下信息：

帳戶信息（名稱、電子郵件、組織）
使用信息（請求、查詢、結果）
技術信息（IP 地址、瀏覽器、設備）
支付信息（用於付費用戶）

8.2 數據使用

我們使用收集的數據用於：

提供和改進服務
檢測和防止濫用
遵守法律義務
與您溝通

8.3 數據共享

我們不會與第三方共享您的個人數據，除非：

您明確同意
法律要求
執法部門要求

8.4 數據保留

活躍用戶的數據：保留期間為帳戶活躍期間加 1 年
已刪除帳戶的數據：保留 90 天後刪除
審計日誌：保留 2 年

9. 修改和更新

9.1 修改權利

Capafy AI 保留隨時修改本協議的權利。

9.2 通知

重大修改時，我們將通過電子郵件或在 Skill 中發出通知。

9.3 持續使用

在修改後繼續使用本 Skill 即表示您同意新條款。

10. 聯繫方式

10.1 合規查詢

如有合規或法律相關的問題，請聯繫：

郵件:[email protected]
地址: [Capafy AI 辦公室地址]

10.2 舉報違規

如果您發現本 Skill 被用於非法目的或違規行為，請立即舉報：

舉報郵件: [email protected]
緊急情況: 聯繫當地執法部門

11. 生效日期和版本

版本: 1.0.0
生效日期: 2026-07-20
最後更新: 2026-07-20
下一次審查: 2026-12-20

12. 簽名和同意

通過使用本 Skill，您確認已閱讀、理解並同意遵守本協議中的所有條款和條件。

如果您不同意任何條款，請立即停止使用本 Skill。

Capafy AI 保留最終解釋權。

**如有任何疑問，請聯繫 [email protected]

錯誤碼表

版本: 1.0.0
適用於: Skill A、B、C、D

概述

本文檔列出了所有可能的錯誤碼、含義、常見原因和解決方案。

錯誤碼分類

範圍	類型	說明
1000-1999	輸入驗證錯誤	請求參數無效
2000-2999	認證和授權錯誤	認證失敗或權限不足
3000-3999	速率限制和配額	超過限制
4000-4999	合規和安全錯誤	違反合規規則
5000-5999	服務錯誤	伺服器內部錯誤
6000-6999	外部服務錯誤	依賴服務失敗

輸入驗證錯誤 (1000-1999)

1001: 缺少必需參數

含義: 請求中缺少必需的參數

常見原因:

忘記提供必需參數
參數名稱拼寫錯誤
使用了舊版本的 API

解決方案:

檢查 API 文檔，確認所有必需參數
驗證參數名稱的拼寫
升級到最新版本的 API

示例:

{
  "error_code": 1001,
  "message": "缺少必需參數: brand_url",
  "missing_parameters": ["brand_url"]
}

1002: 無效的參數值

含義: 參數值不符合預期格式或範圍

常見原因:

URL 格式無效
數字超出範圍
枚舉值不正確

解決方案:

檢查參數值的格式
確保值在允許的範圍內
參考 API 文檔中的有效值列表

示例:

{
  "error_code": 1002,
  "message": "無效的參數值",
  "parameter": "mode",
  "value": "invalid_mode",
  "valid_values": ["fast", "deep"]
}

1003: 無效的 URL 格式

含義: 提供的 URL 格式無效

常見原因:

URL 缺少協議（http:// 或 https://）
URL 包含無效字符
URL 過長

解決方案:

確保 URL 以 http:// 或 https:// 開頭
檢查 URL 中是否有特殊字符
確保 URL 長度不超過 2048 字符

示例:

{
  "error_code": 1003,
  "message": "無效的 URL 格式",
  "url": "example.com",
  "suggestion": "URL 應以 http:// 或 https:// 開頭"
}

1004: 參數類型錯誤

含義: 參數的數據類型不正確

常見原因:

傳遞字符串而應傳遞數字
傳遞數字而應傳遞布爾值
傳遞字符串而應傳遞數組

解決方案:

檢查參數的預期數據類型
確保值的類型與預期相符
必要時進行類型轉換

示例:

{
  "error_code": 1004,
  "message": "參數類型錯誤",
  "parameter": "content_count",
  "expected_type": "integer",
  "received_type": "string"
}

認證和授權錯誤 (2000-2999)

2001: 缺少 API 密鑰

含義: 請求中未提供 API 密鑰

常見原因:

忘記在請求頭中添加 API 密鑰
API 密鑰過期
API 密鑰被撤銷

解決方案:

在請求頭中添加 Authorization: Bearer YOUR_API_KEY
檢查 API 密鑰是否過期
如果密鑰被撤銷，申請新的密鑰

示例:

curl -H "Authorization: Bearer your_api_key" \
  https://api.capafy.ai/skill-a/run

2002: 無效的 API 密鑰

含義: 提供的 API 密鑰無效或不正確

常見原因:

API 密鑰拼寫錯誤
使用了舊的或已撤銷的密鑰
API 密鑰格式不正確

解決方案:

驗證 API 密鑰是否正確
檢查密鑰是否已過期或被撤銷
生成新的 API 密鑰

2003: 權限不足

含義: 用戶沒有執行此操作的權限

常見原因:

使用了免費帳戶但嘗試訪問付費功能
帳戶權限被限制
嘗試訪問他人的資源

解決方案:

升級帳戶到付費計劃
聯繫支持團隊申請權限
確保只訪問自己的資源

2004: 帳戶已禁用

含義: 用戶帳戶已被禁用

常見原因:

違反服務條款
多次違規
欠費

解決方案:

檢查郵件中的禁用原因
如果是誤禁，聯繫支持團隊申訴
如果是欠費，完成付款

速率限制和配額錯誤 (3000-3999)

3001: 超過 RPS 限制

含義: 請求頻率超過允許的每秒請求數（RPS）

常見原因:

發送請求過於頻繁
使用自動化工具而未考慮速率限制
多個客戶端同時發送請求

解決方案:

減少請求頻率
實現指數退避重試策略
使用 Retry-After 頭中指定的等待時間

示例:

{
  "error_code": 3001,
  "message": "超過 RPS 限制",
  "current_rps": 15,
  "limit_rps": 10,
  "retry_after_seconds": 2
}

3002: 超過月度配額

含義: 已超過月度 API 調用配額

常見原因:

使用量超過計劃限制
多個應用共享同一個 API 密鑰

解決方案:

升級到更高的計劃
優化 API 使用，減少不必要的調用
等待月度配額重置

合規和安全錯誤 (4000-4999)

4001: 檢測到隱私數據違規

含義: 請求包含個人隱私數據

常見原因:

無意中在請求中包含個人信息
爬取的內容包含個人信息

解決方案:

檢查請求中是否包含個人信息
使用 API 提供的隱私過濾功能
確保只爬取必要的公開信息

示例:

{
  "error_code": 4001,
  "message": "檢測到隱私數據違規",
  "detected_data_types": ["phone", "email"],
  "action": "request_rejected",
  "suggestion": "請移除個人信息後重試"
}

4002: 檢測到著作權違規

含義: 請求的內容可能受版權保護

常見原因:

嘗試爬取受版權保護的內容
URL 來自受保護的域名

解決方案:

檢查內容是否受版權保護
確保有權使用該內容
使用開放許可或公開域名的內容

示例:

{
  "error_code": 4002,
  "message": "檢測到著作權違規",
  "risk_score": 0.85,
  "reason": "URL 來自受保護的域名: getty images",
  "action": "request_rejected"
}

4003: 禁止的使用場景

含義: 檢測到禁止的使用場景

常見原因:

嘗試用於非法目的
違反服務條款

解決方案:

確保使用場景合法
閱讀服務條款
聯繫支持團隊了解允許的使用場景

服務錯誤 (5000-5999)

5001: 內部伺服器錯誤

含義: 伺服器發生內部錯誤

常見原因:

伺服器故障
代碼 bug
資源耗盡

解決方案:

等待幾分鐘後重試
檢查系統狀態頁面
聯繫支持團隊

5002: 服務不可用

含義: 服務暫時不可用

常見原因:

伺服器維護
服務過載
網絡問題

解決方案:

等待服務恢復
檢查系統狀態頁面
稍後重試

5003: 請求超時

含義: 請求超過最大等待時間

常見原因:

伺服器響應緩慢
網絡連接不穩定
請求處理時間過長

解決方案:

檢查網絡連接
減少請求的複雜性
增加超時時間設置

外部服務錯誤 (6000-6999)

6001: 數據源不可用

含義: 無法訪問所需的數據源

常見原因:

數據源服務器離線
網絡連接問題
數據源 API 變更

解決方案:

檢查數據源的狀態
驗證網絡連接
聯繫支持團隊

6002: 第三方 API 錯誤

含義: 第三方 API 返回錯誤

常見原因:

第三方服務故障
API 配額已滿
API 密鑰無效

解決方案:

檢查第三方服務的狀態
驗證 API 配置
聯繫第三方服務支持

常見錯誤組合和解決方案

場景 1: 無法認證

錯誤: 2001 + 2002

解決方案:

確認 API 密鑰正確
檢查密鑰是否已過期
生成新的 API 密鑰

場景 2: 請求被拒絕

錯誤: 4001 + 4002

解決方案:

檢查請求中是否包含個人信息
驗證內容是否受版權保護
確保使用場景合法

場景 3: 服務不穩定

錯誤: 5001 + 5002 + 5003

解決方案:

實現重試機制
使用指數退避策略
監控系統狀態

錯誤處理最佳實踐

1. 實現重試機制

import time

def retry_with_backoff(func, max_retries=3):
    for attempt in range(max_retries):
        try:
            return func()
        except Exception as e:
            if attempt == max_retries - 1:
                raise
            wait_time = 2 ** attempt  # 指數退避
            print(f"重試 {attempt + 1}/{max_retries}，等待 {wait_time} 秒")
            time.sleep(wait_time)

2. 檢查錯誤碼

if error_code >= 3000 and error_code < 4000:
    # 速率限制錯誤，等待後重試
    wait_time = response.headers.get('Retry-After', 60)
    time.sleep(int(wait_time))
elif error_code >= 4000 and error_code < 5000:
    # 合規錯誤，不應重試
    raise ValueError(f"合規錯誤: {error_message}")
elif error_code >= 5000:
    # 服務錯誤，可以重試
    retry_with_backoff(lambda: make_request())

3. 記錄錯誤

import logging

logger = logging.getLogger(__name__)

try:
    response = make_request()
except Exception as e:
    logger.error(f"API 錯誤: {e.error_code} - {e.message}")
    logger.debug(f"詳細信息: {e.details}")

支持和反饋

如果您遇到未在本文檔中列出的錯誤，或需要幫助理解錯誤，請聯繫：

郵件: [email protected]

最後更新: 2026-07-20
版本: 1.0.0

常見問題解答 (FAQ)

版本: 1.0.0
最後更新: 2026-07-20

法律和合規相關

Q1: 本 Skill 是否合法？

A: 是的，本 Skill 完全合法。我們遵守全球所有適用的法律和法規，包括 GDPR、台灣個資法、中國個人信息保護法等。

但是，您使用 Skill 的方式必須合法。禁止用於非法目的、侵犯他人權利或違反當地法律。

Q2: 我可以用本 Skill 做什麼？

A: 您可以使用本 Skill 進行以下合法活動：

市場研究: 分析市場趨勢、競品、行業動態
內容生成: 為社群媒體、網站、營銷活動生成內容
媒體製作: 生成視頻、圖像、音頻、投影片
數據分析: 分析公開數據進行商業決策
教育和研究: 用於學術研究和教育目的

Q3: 我不能用本 Skill 做什麼？

A: 您絕對不能使用本 Skill 進行以下活動：

非法活動（詐騙、洗錢、販毒等）
侵犯他人隱私（爬取個人信息）
侵犯著作權或知識產權
騷擾、威脅或恐嚇他人
歧視或仇恨言論
性剝削或兒童虐待
任何其他違法行為

Q4: 如果我違反了規則會怎樣？

A: 根據違規的嚴重程度，可能面臨以下後果：

輕微違規: 警告和帳戶限制
中等違規: 帳戶暫停 7-30 天
嚴重違規: 帳戶永久禁用
非法活動: 可能面臨法律訴訟

Q5: 我的數據會被保存嗎？

A: 我們只保存必要的數據用於服務運營和安全監控：

個人信息: 不會被保存（自動遮蔽）
審計日誌: 保留 2 年用於安全和合規
使用數據: 保留用於改進服務
已刪除帳戶: 90 天後完全刪除

隱私和數據保護相關

Q6: 本 Skill 如何保護我的隱私？

A: 我們採取多層隱私保護措施：

自動遮蔽: 自動檢測和遮蔽所有個人信息
不存儲: 個人信息不會被保存
加密傳輸: 所有數據使用 SSL/TLS 加密
訪問控制: 只有授權人員可以訪問數據
審計日誌: 所有訪問都有記錄

Q7: 如果 Skill 檢測到我的個人信息會怎樣？

A: 以下是 Skill 的自動處理流程：

檢測: 自動檢測個人信息（電話、郵件、ID 等）
遮蔽: 自動遮蔽個人信息
記錄: 記錄檢測到的信息類型（不保存實際內容）
警告: 發送警告通知用戶
拒絕: 如果信息過多，可能拒絕請求

Q8: 我可以要求刪除我的數據嗎？

A: 是的，您有權要求刪除您的數據。根據 GDPR 和其他隱私法規，您可以：

訪問: 要求查看我們持有的您的數據
更正: 要求更正不准確的數據
刪除: 要求刪除您的數據（"被遺忘權"）
導出: 要求以機器可讀格式導出您的數據

提交請求: 發送郵件至 [email protected]

Q9: 我的數據會被分享給第三方嗎？

A: 不會。我們不會與第三方分享您的個人數據，除非：

您明確同意
法律要求（如執法部門）
保護我們的權利或安全

著作權和知識產權相關

Q10: 我可以爬取受版權保護的內容嗎？

A: 不可以。本 Skill 禁止爬取受版權保護的內容。

我們實施以下保護措施：

自動檢測: 檢測內容中的版權符號
域名檢查: 檢查是否來自受保護的域名
風險評分: 評估著作權風險
自動阻止: 風險高時自動阻止

Q11: 什麼是"合理使用"？

A: 合理使用是指在特定情況下可以使用受版權保護的內容，包括：

教育: 用於課堂教學或學術研究
評論: 用於評論或批評
新聞報導: 用於新聞報導
模仿: 用於模仿或諷刺

但是，合理使用的定義因國家而異。建議在使用前查詢當地法律。

Q12: 我可以使用 Creative Commons 內容嗎？

A: 是的，您可以使用 Creative Commons (CC) 許可的內容，但必須：

遵守許可: 遵守特定的 CC 許可條款
署名: 標註原作者（如許可要求）
保持許可: 衍生作品使用相同許可（如適用）

常見的 CC 許可：

CC0: 公開域，無限制使用
CC-BY: 需要署名
CC-BY-SA: 需要署名和相同許可
CC-BY-NC: 需要署名，非商業用途

速率限制相關

Q13: 什麼是速率限制？

A: 速率限制是指每秒允許的最大請求數（RPS）。

用戶類型	限制	說明
免費用戶	10 RPS	每秒最多 10 個請求
付費用戶	50 RPS	每秒最多 50 個請求
企業用戶	自定義	根據合同自定義

Q14: 超過速率限制會怎樣？

A: 如果超過速率限制：

第一次: 返回 429 Too Many Requests 錯誤
建議: 等待 Retry-After 頭中指定的時間
多次違規: 帳戶可能被暫時禁用
惡意行為: 帳戶可能被永久禁用

Q15: 如何避免超過速率限制？

A: 以下是最佳實踐：

實現重試機制: 使用指數退避重試
監控請求: 跟蹤您的請求頻率
批量請求: 合併多個請求為一個
升級計劃: 如果需要更高的限制，升級到付費計劃

示例代碼:

import time

def make_request_with_retry(url, max_retries=3):
    for attempt in range(max_retries):
        try:
            response = requests.get(url)
            if response.status_code == 429:
                wait_time = int(response.headers.get('Retry-After', 60))
                print(f"超過限制，等待 {wait_time} 秒")
                time.sleep(wait_time)
                continue
            return response
        except Exception as e:
            if attempt == max_retries - 1:
                raise
            time.sleep(2 ** attempt)

技術相關

Q16: 哪些編程語言支持？

A: 本 Skill 提供 REST API，支持所有編程語言。我們提供以下語言的示例：

Python
JavaScript/Node.js
Java
C#
Go
Ruby
PHP

Q17: 我可以離線使用本 Skill 嗎？

A: 不可以。本 Skill 是基於雲的服務，需要網絡連接。

但是，您可以：

緩存結果以減少 API 調用
使用本地數據庫存儲結果
實現離線模式（使用緩存的數據）

Q18: 本 Skill 支持 Webhook 嗎？

A: 是的，我們支持 Webhook 用於異步通知。

您可以配置 Webhook 在以下事件發生時接收通知：

任務完成
任務失敗
檢測到隱私數據
檢測到著作權問題

配置 Webhook:

curl -X POST https://api.capafy.ai/webhooks \
  -H "Authorization: Bearer your_api_key" \
  -d '{
    "url": "https://your-domain.com/webhook",
    "events": ["job_completed", "job_failed"]
  }'

Q19: 如何調試 API 問題？

A: 以下是調試步驟：

檢查日誌: 查看 API 響應中的詳細錯誤信息
使用 curl: 使用 curl 測試 API 端點
檢查頭部: 驗證所有必需的頭部（Authorization 等）
驗證參數: 確保所有參數正確
聯繫支持: 如果問題持續，聯繫支持團隊

支持和反饋

Q23: 如何獲得技術支持？

A: 支持渠道：

郵件: [email protected]（24 小時內回覆）

其他問題

Q26: 本 Skill 的數據準確度如何？

A: 我們的數據準確度超過 95%，具體取決於：

數據源: 公開數據通常比專有數據更準確
處理方法: 我們使用先進的 NLP 和機器學習
驗證: 我們對結果進行多層驗證

但是，我們不保證 100% 準確度。建議對重要決策進行人工驗證。

Q27: 本 Skill 支持多語言嗎？

A: 是的，我們支持 50+ 種語言，包括：

中文（簡體和繁體）
英文
日文
韓文
西班牙文
法文
德文
等等

Q28: 本 Skill 可以集成到我的應用中嗎？

A: 是的，完全可以。我們提供：

REST API: 標準 HTTP API
SDK: Python、JavaScript、Java、C# 等
Webhooks: 異步事件通知
OAuth2: 用於用戶認證

聯繫我們

如果您的問題未在本 FAQ 中列出，請聯繫：

郵件: [email protected]
網站: https://capafy.ai

最後更新: 2026-07-20
版本: 1.0.0

Market Entry Radar

I built this Skill to help traders and market researchers scan current opportunities across stocks, forex, commodities, indices and crypto using a hybrid technical framework. It combines trend, range, mean reversion, breakout/retest, VWAP/POC, news context and sentiment-aware filters. The Skill prioritizes verified market data, clear long/short setups, risk levels, backtest availability and a local visual dashboard. Research only — not financial advice.

US$19.99