在構建需要經濟、健康、教育或環境數據的智能體時，直接對接 OECD 的 SDMX API 往往需要處理繁瑣的元數據結構。xby-oecd-search 作爲一個 DSH 插件，通過封裝 SDMX API，將獲取 OECD 統計數據的能力集成到聊天界面中。
是什麼¶
這是一個通過 SDMX API 提供全面 OECD 統計數據的模型上下文協議（MCP）服務器插件。
核心功能¶
- set_xby_apikey: 在聊天中設置 API 密鑰，該操作會自動持久化，重啓後依然有效。
- search_dataflows: 按關鍵詞搜索 OECD 數據集（dataflows），返回匹配數據集的 ID、名稱和描述。
- list_dataflows: 列出所有可用的數據集，支持按類別篩選，用於按主題瀏覽數據。
- get_data_structure: 獲取特定數據集的元數據和結構，包括維度、屬性和查詢的有效值。
- query_data: 查詢實際統計數據。⚠️ 默認返回最近 100 條觀察值（最大支持 1000 條），需指定限制以處理大數據集。
- get_categories: 獲取所有可用的 OECD 數據類別（共 17 個類別，涵蓋經濟、健康、教育、環境等）。
- get_popular_datasets: 獲取經過精選的常用數據集列表。
- search_indicators: 按關鍵詞搜索特定的經濟或社會指標（如 “inflation”, “unemployment”, “GDP”）。
- get_dataflow_url: 生成 OECD 數據瀏覽器的直接鏈接，方便在瀏覽器中可視化查看數據。
- list_categories_detailed: 獲取所有 17 個類別的詳細信息，並附帶每個類別的示例數據集。
安裝與啓用¶
通過以下命令安裝插件：
dsh plugin --profile web add github:xby_skill/xby-oecd-search
典型用法¶
- 獲取密鑰: 使用前需通過小笨羊官網獲取 API 密鑰。
- 設置密鑰: 在聊天中輸入
set_xby_apikey <your_key>進行設置。 - 查詢數據:
query_data默認返回 100 條記錄。對於大數據集（例如 SOCX_AGG），單次請求可能超過 70,000 條記錄，必須顯式指定限制參數以避免上下文溢出。 - 生成鏈接: 使用
get_dataflow_url可以直接生成數據集的瀏覽器訪問鏈接。
適用場景與注意¶
該插件適合需要訪問 OECD 統計數據的場景。需要注意的是，query_data 接口有默認的數據量限制，處理大規模數據集時必須手動指定參數。
插件以當前 DSH 進程的權限運行，使用前應檢查源碼與許可證（MIT）。
