xby-philippine-geocoding

Readme

# xby-philippine-geocoding

DeepSeek Harness (DSH) 的插件：菲律宾地理编码服务

提供菲律宾标准地理编码（PSGC）API访问的模型上下文协议（MCP）服务器，包含完整的菲律宾地理层级数据。

## 功能

- **set_xby_apikey** — 在聊天中设置 API 密钥（自动持久化，重启有效）
- **get_island_groups** — List all island groups in the Philippines
- **get_island_group** — Get specific island group by code
- **get_island_group_regions** — Get all regions within a specific island group
- **get_island_group_provinces** — Get all provinces within a specific island group
- **get_island_group_cities** — Get all cities within a specific island group
- **get_island_group_municipalities** — Get all municipalities within a specific island group
- **get_island_group_barangays** — Get all barangays within a specific island group
- **get_regions** — List all regions in the Philippines
- **get_region** — Get specific region by code
- **get_region_provinces** — Get all provinces within a specific region
- **get_region_districts** — Get all districts within a specific region
- **get_region_cities** — Get all cities within a specific region
- **get_region_municipalities** — Get all municipalities within a specific region
- **get_region_cities_municipalities** — Get all cities and municipalities within a specific region
- **get_region_sub_municipalities** — Get all sub-municipalities within a specific region
- **get_region_barangays** — Get all barangays within a specific region
- **get_provinces** — List all provinces in the Philippines
- **get_province** — Get specific province by code
- **get_province_cities** — Get all cities within a specific province
- **get_province_municipalities** — Get all municipalities within a specific province
- **get_province_cities_municipalities** — Get all cities and municipalities within a specific province
- **get_province_sub_municipalities** — Get all sub-municipalities within a specific province
- **get_province_barangays** — Get all barangays within a specific province
- **get_cities** — List all cities in the Philippines
- **get_city** — Get specific city by code
- **get_city_barangays** — Get all barangays within a specific city
- **get_municipalities** — List all municipalities in the Philippines
- **get_municipality** — Get specific municipality by code
- **get_municipality_barangays** — Get all barangays within a specific municipality
- **get_barangays** — List all barangays in the Philippines
- **get_barangay** — Get specific barangay by code
- **get_districts** — List all districts in the Philippines
- **get_district** — Get specific district by code
- **get_district_cities** — Get all cities within a specific district
- **get_district_municipalities** — Get all municipalities within a specific district
- **get_district_cities_municipalities** — Get all cities and municipalities within a specific district
- **get_district_sub_municipalities** — Get all sub-municipalities within a specific district
- **get_district_barangays** — Get all barangays within a specific district
- **search_by_name** — Search for geographic entities by name across all levels (regions, provinces, cities, municipalities, barangays)
- **get_hierarchy** — Get complete geographic hierarchy for a specific code (shows parent entities)
- **validate_code** — Validate if a geographic code exists and return its type

## 安装

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

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

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

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

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

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



## 配置

### 获取 API 密钥

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