AIから検索APIを使う

まず使うもの

AIに直接読ませる場合は、上のOpenAPI定義を指定してください。 人間が試すだけなら、次のURLで同じ検索を確認できます。

GET https://tools.miya.be/api/search?q=盛土%20メガソーラー

省略時は会議録検索です。例規集を検索する場合は doc_type=reiki を付けます。

GET https://tools.miya.be/api/search?doc_type=reiki&q=個人情報保護

検索結果の api_document_url を呼ぶと、その文書の全文テキストをJSONで取得できます。

GET https://tools.miya.be/api/document?id=検索結果のid&doc_type=minutes

AI別の考え方

ChatGPT / GPTs

GPT Actions はOpenAPIスキーマを使って外部APIを呼び出します。 Actionsに https://tools.miya.be/openapi.json を読み込ませるのが最短です。 このAPIは認証なしで検索できます。 OpenAIの説明

Claude

ClaudeのコネクタはMCPが中心です。Claudeに常設ツールとして持たせるなら、 このOpenAPI定義をそのまま登録するより、/api/search を呼ぶ小さなMCPサーバーを用意するのが自然です。 Claude Connectors

Gemini / Vertex AI

Gemini APIのfunction callingでは関数宣言を渡します。Vertex AI Extensions ではOpenAPI 3.0互換のYAMLをAPI仕様として使えます。 Vertex側に取り込む場合は openapi.yaml を基にしてください。 Vertex AI Extensions

Microsoft Copilot Studio

Copilot StudioのREST APIツールやカスタムコネクタでは、OpenAPI仕様ファイルをアップロードしてツール化できます。 取り込み時は openapi.yaml または openapi.json を使います。 REST API tool

AIに渡す短い指示例

カスタムGPTやエージェントの説明には、次のような指示を入れると安定します。

自治体の会議録・例規集を調べるときは searchMunicipalDocuments を使う。
まず doc_type=minutes で会議録を検索する。
条例や規則そのものを探すときだけ doc_type=reiki を使う。
地域が指定されたら pref_code または slug で絞る。
回答では title, municipality_name, held_on または sort_date, excerpt, source_url を根拠として示す。
excerpt は抜粋なので、必要なら api_document_url で全文を取得して確認する。
最終確認が必要な場合は source_url の原サイトも示す。

主なパラメータ

q

必須。検索語です。例: 盛土 メガソーラー

doc_type

minutes は会議録、reiki は例規集です。省略すると minutes になります。

pref_code

都道府県コードです。例: 神奈川県は 14。

slug

自治体を1つに絞るIDです。検索結果や検索画面のURLに含まれます。

start_year / end_year

対象年を絞ります。例: start_year=2020&end_year=2024。

sort

date は新しい順、relevance は関連度順です。

page / per_page

ページ番号と1ページあたりの件数です。per_page は最大100件です。

検索語の書き方

盛土 メガソーラー

複数語はAND検索です。

"同和団体" 温泉

引用符で囲んだ語句を完全一致にし、ほかの語と組み合わせます。

盛土 OR 土砂

どちらかを含む文書を探します。

メガソーラー NOT 促進

後ろの語を含む文書を除外します。

返ってくる項目

total

ヒット件数です。

items

検索結果の配列です。

title

会議名、条例名、文書名などです。

excerpt

該当箇所の抜粋です。検索語は [[[ と ]]] で囲まれます。

detail_url

ブラウザで見るための詳細ページです。会議録ではサイト内の全文表示ページ、例規集では原サイト等のURLです。

api_document_url

その文書の全文をJSONで取得するAPI URLです。

body

/api/document で返る全文テキストです。検索結果の一覧には含まれません。

source_url

自治体や配信元の原サイトです。最終確認に使います。

注意点

このAPIは調査の入口です。AIの回答では、検索結果の抜粋だけで断定せず、 重要な内容は api_document_url で全文を確認してください。 必要に応じて source_url の原サイトも確認してください。 会議録と例規集は性格が違うため、原則として別々に検索します。