在构建需要经济、健康、教育或环境数据的智能体时，直接对接 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）。
