AI Skills
household-waste-info

household-waste-info

热门

当用户按区域名称（市/郡/区）查询生活垃圾的投放星期、时间及地点信息，并希望获取 data.go.kr 官方生活垃圾投放指南时使用。

6464Star
736Fork
更新于 2026/7/23
获取 Skill源代码

相关 Skills

x40211万flox-environments24万agent-dev-backend-api7.1万
SKILL.md
只读
名称
household-waste-info
描述

当用户按区域名称（市/郡/区）查询生活垃圾的投放星期、时间及地点信息，并希望获取 data.go.kr 官方生活垃圾投放指南时使用。

Household Waste Info

功能说明

通过查询韩国行政安全部生活垃圾排放信息 Open API，提供各区域生活垃圾、厨余垃圾及可回收物的投放标准与星期/时间信息。

  • 默认查询单位为市/郡/区名称（SGG_NM）。
  • 响应结果会整理为易于用户理解的摘要形式。
  • Base URL 以原 API（https://apis.data.go.kr/1741000/household_waste_info）为准。
  • 仅 serviceKey（DATA_GO_KR_API_KEY）由 Proxy 服务器负责注入和管理。

适用场景

  • “帮我查下江南区哪天倒垃圾”
  • “我们小区厨余垃圾什么时候扔？”
  • “帮我查一下可回收物的投放时间”
  • “查一下生活垃圾的投放地点和方法”

前置条件

  • 网络连接
  • 支持 curl 和 python3 的运行环境
  • 可访问原 API 的网络环境
  • 可访问 API Key 注入 Proxy 的网络环境

凭据要求

原则上用户端无需提供必需的 API Key。

可选环境变量：

  • KSKILL_PROXY_BASE_URL（自建 Proxy 时使用）

凭据使用原则：

  1. 端点/参数体系遵循原 API。
  2. serviceKey 的值由 Proxy 服务器管理并注入。
  3. 用户本地环境无需配置 DATA_GO_KR_API_KEY。

官方 API 接口

  • Base URL: https://apis.data.go.kr/1741000/household_waste_info
  • Endpoint: GET /info
  • （仅进行密钥注入）Proxy：由 k-skill-proxy 在服务端注入 serviceKey

默认路径

无需额外的客户端 API 层。Base URL 保持以原 API 为准。

当前 Proxy 支持的查询参数：

  • cond[SGG_NM::LIKE]：市/郡/区名称模糊搜索（必填）
  • pageNo / numOfRows（或 page_no / num_of_rows）：必填，值必须为 1 / 100 —— 其他值或非纯数字字符串将返回 400。上游接口始终仅传递第 1 页、100 条记录。
  • returnType：Proxy 始终强制为 json —— 客户端传入的值将被忽略
  • serviceKey：由 Proxy 在服务端注入 —— 禁止客户端传递

原 API 中如 cond[DAT_CRTR_YMD::*]、cond[DAT_UPDT_PNT::*] 等附加筛选条件目前不会在 Proxy 路由中透传。用户发起的常见查询（如“江南区垃圾投放星期”）仅靠市/郡/区维度搜索即已足够；如有需要，可在客户端对响应数据按 DAT_UPDT_PNT 进行排序。

工作流

1) 首先确认位置

不要在未掌握用户具体区域信息的情况下直接查询。

  • 推荐提问方式：请告诉我需要查询的区域（市/郡/区）。例如：江南区、水原市灵通区

2) 验证输入并解析查询

  • 若市/郡/区输入为空，则再次询问。
  • 若输入含义模糊，则提示用户补充上一级行政区划后重新提问。

3) 通过 Proxy 调用（服务端注入 serviceKey）

Proxy 在服务端注入 serviceKey 后转发至原 API。

curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/household-waste/info' \
  --data-urlencode "cond[SGG_NM::LIKE]=강남구" \
  --data-urlencode "pageNo=1" \
  --data-urlencode "numOfRows=100"

由于 Proxy 始终强制 returnType 为 json，因此客户端无需额外发送该参数。

若设置了 KSKILL_PROXY_BASE_URL 则使用该值，否则默认使用托管 Proxy（k-skill-proxy.nomadamas.org）。

4) 为用户生成摘要

仅提取响应数据中的核心字段并进行简要整理。

  • 管理区域/目标区域 (MNG_ZONE_NM, MNG_ZONE_TRGT_RGN_NM)
  • 投放地点/投放方法 (EMSN_PLC, LF_WST_EMSN_MTHD, FOD_WST_EMSN_MTHD, RCYCL_EMSN_MTHD)
  • 投放星期/时间 (LF_WST_EMSN_DOW, FOD_WST_EMSN_DOW, RCYCL_EMSN_DOW 及各自的起始/结束时间)
  • 暂停清运日 (UNCLLT_DAY)
  • 咨询部门/电话 (MNG_DEPT_NM, MNG_DEPT_TELNO)

完成标准

  • 已确认用户所在区域（市/郡/区）。
  • 已成功调用 Proxy /v1/household-waste/info 接口。
  • 已将投放星期/时间/地点归纳为 3~6 个核心要点并答复用户。

异常情况

  • Proxy 服务器缺失或 DATA_GO_KR_API_KEY 已过期（serviceKey 注入失败）
  • 搜索的区域名称与 API 数据不匹配导致结果为空
  • 公共数据 API 临时故障或触发限流
  • 缺失必填参数（未传递 cond[SGG_NM::LIKE]，或未传递 pageNo / numOfRows）
  • pageNo / numOfRows 的值不为 1 / 100，或传入了包含非数字字符的字符串（Proxy 返回 400，不上游调用）

注意事项

  • 用户端切勿存储 DATA_GO_KR_API_KEY，仅在 Proxy 服务器端统一管理。
  • 切勿直接展示 API 原始 Payload，需转换为对用户友好的摘要格式。
  • 若返回多条记录，优先按最新的 DAT_UPDT_PNT 排序展示。
  • 官方数据来源：公共数据门户（https://www.data.go.kr）