xby-oecd-search

Readme

# xby-oecd-search

DeepSeek Harness (DSH) 的插件：OECD数据查询服务

一个通过SDMX API提供OECD全面统计数据的模型上下文协议（MCP）服务器，支持AI助手和聊天机器人查询经济、健康、教育、环境等OECD数据集。

## 功能

- **set_xby_apikey** — 在聊天中设置 API 密钥（自动持久化，重启有效）
- **search_dataflows** — Search for OECD datasets (dataflows) by keyword. Returns matching datasets with their IDs, names, and descriptions.
- **list_dataflows** — List available OECD dataflows (datasets), optionally filtered by category. Use this to browse datasets by topic area.
- **get_data_structure** — Get the metadata and structure of a specific OECD dataset. Returns dimensions, attributes, and valid values for querying data.
- **query_data** — Query actual statistical data from an OECD dataset. ⚠️ IMPORTANT: Defaults to last 100 observations (max 1000) to protect context window. Use filters, time periods, or last_n_observations to control data size. Large datasets (e.g. SOCX_AGG) can have 70,000+ observations - always specify limits!
- **get_categories** — Get all available OECD data categories (17 categories covering all topics: Economy, Health, Education, Environment, etc.)
- **get_popular_datasets** — Get a curated list of commonly used OECD datasets across all categories.
- **search_indicators** — Search for specific economic or social indicators by keyword (e.g., "inflation", "unemployment", "GDP").
- **get_dataflow_url** — Generate an OECD Data Explorer URL for a dataset. Use this to provide users with a direct link to explore data visually in their browser.
- **list_categories_detailed** — Get all OECD data categories with example datasets for each category. Returns comprehensive information about all 17 categories.

## 安装

### 方式一：从 GitHub 直接安装（推荐）

```bash
# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-oecd-search
```

### 方式二：从本地目录安装（开发模式）

```bash
# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-oecd-search
```

### 方式三：通过 cordis.patch.yml 开发调试

```bash
dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml
```



## 配置

### 获取 API 密钥

前往 [小笨羊官网](https://xiaobenyang.com) 注册并获取 API 密钥。