「ごみ当ちゃん API」の概要
ごみ当ちゃん API（以下、ごみ当ちゃんAPI）は、LINEボットサービス「ごみ当ちゃん」の機能の一部を、プログラムから利用できるようにしたインタフェースです。
2025年11月に投稿したブログ「【お知らせ】ごみ当ちゃん 公開API（ベータ版）提供開始について」でお知らせした通り、ごみ当ちゃんが提供する一部の機能を、別のプログラムや利用シーンが増えている「AIエージェント」から利用できるよう、APIとして公開しました。現在はベータ版の位置付けで、利用の将来性を含め、利用者からのフィードバックをいただきながら改善を進めていきます。
仕様を含めた詳細な情報については次のサイトをご参照ください。
利用可能なAPI
「ごみ当ちゃんAPI」で利用可能なAPIは次の通りです。プログラムからの利用だけでなく、AIエージェントから「ツール」として利用できるよう、MCP/UTCPの両方のプロトコルに対応しています。
- ごみ分別検索：ごみ分別方法を確認したい市区町村とごみ品目を指定して検索し、類似した品目含め、品目毎でのごみ分別方法を返却します。提供するごみ分別情報は「利用可能なごみ分別自治体リスト」をご参照ください。
- UTCPマニュアルの取得：Universal Tool Calling Protocol (UTCP)に従い、AIエージェントからツールとしてのごみ当ちゃんのAPIを呼び出すためのマニュアル(JSON)を提供します。
UTCPの概要については、こちらのリンクをご参照ください。ツールとしては「ごみ分別検索」のみを提供します。 - MCPサーバによるAPI利用：Model Context Protocol（MCP）に従い、AIエージェントからツールとしてのごみ当ちゃんのAPIを呼び出すための各種操作(initialize, notifications/initialized, tools/list, tools/call)を提供します。
MCPの概要については、こちらのリンクをご参照ください。ツールとしては「ごみ分別検索」のみを提供します。
利用手続き
ご興味がある方は「API利用申し込み」サイトから申請を行ってください。申請後、管理人にて確認後、申請した方宛に認証のためのAPIキーを発行します。
各種仕様
ごみ当ちゃんAPIの各種仕様については、以下のリンク先のドキュメントをご参照ください。ドキュメントは Swagger UI や Redoc を通じて参照可能です。
API のエンドポイント、リクエスト／レスポンス形式、認証方式、制限事項などを必ず把握してください。
注意点と運用上の考慮
- ご利用前に、「API利用申し込み」サイトに記載のAPI利用規約をご確認ください。
- 「ごみ当ちゃん API」 は現時点で「ベータ版」です。仕様変更やデータ提供対象自治体の追加・削除がある可能性があります。
- ごみ分別情報が取得できる自治体は限られており、すべての市区町村が対象ではありません。API を使う前に、「利用可能なごみ分別自治体リスト」にて、利用可能な自治体を確認してください。
- 取得したAPI キーは安全に管理してください。
- MCP／UTCP を使う場合、ユーザーの「自治体」「設定したごみスケジュール」「通知タイミング」といったコンテキスト管理が必要です。
各種お問い合わせについて
「ごみ当ちゃんAPI」に関する内容、技術仕様、利用手続き、および利用上の各種問題報告等については、お問い合わせフォームにてご連絡をお願いいたします。