ドキュメント

curl --get "https://api.example.jp/api/v1/search" \
  --data-urlencode "address=東京都千代田区丸の内" \
  -H "x-api-key: YOUR_KEY"

{
  "query": "東京都千代田区丸の内",
  "count": 1,
  "results": [
    { "zipcode": "100-0005", "prefecture": "東京都",
      "city": "千代田区", "town": "丸の内",
      "address": "東京都千代田区丸の内", "kana": "...",
      "prefecture_romaji": "Tokyo", "city_romaji": "Chiyoda-ku",
      "town_romaji": "Marunochi", "romaji": "Marunochi, Chiyoda-ku, Tokyo",
      "score": 266 }
  ]
}

curl "https://api.example.jp/api/v1/lookup?zipcode=100-0005" \
  -H "x-api-key: YOUR_KEY"

curl --get "https://api.example.jp/api/v1/search" \
  --data-urlencode "address=東京都千代田区丸の内" \
  -H "x-api-key: YOUR_KEY"

const url = new URL("https://api.example.jp/api/v1/search");
url.searchParams.set("address", "東京都千代田区丸の内");

const res = await fetch(url, {
  headers: { "x-api-key": "YOUR_KEY" },
});
const data = await res.json();
console.log(data.results);

import requests

res = requests.get(
    "https://api.example.jp/api/v1/search",
    params={"address": "東京都千代田区丸の内"},
    headers={"x-api-key": "YOUR_KEY"},
)
res.raise_for_status()
print(res.json()["results"])

<?php
$query = http_build_query(["address" => "東京都千代田区丸の内"]);
$ch = curl_init("https://api.example.jp/api/v1/search?$query");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_KEY"]);
$body = curl_exec($ch);
curl_close($ch);
$data = json_decode($body, true);
print_r($data["results"]);

require "net/http"
require "json"
require "uri"

uri = URI("https://api.example.jp/api/v1/search")
uri.query = URI.encode_www_form(address: "東京都千代田区丸の内")
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = "YOUR_KEY"

res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
puts JSON.parse(res.body)["results"]

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
)

func main() {
	u, _ := url.Parse("https://api.example.jp/api/v1/search")
	q := u.Query()
	q.Set("address", "東京都千代田区丸の内")
	u.RawQuery = q.Encode()

	req, _ := http.NewRequest("GET", u.String(), nil)
	req.Header.Set("x-api-key", "YOUR_KEY")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	var data map[string]any
	json.NewDecoder(res.Body).Decode(&data)
	fmt.Println(data["results"])
}

claude mcp add address-to-zip \
  --transport http \
  --url https://api.example.jp/mcp \
  --header "x-api-key: YOUR_KEY"

{
  "mcpServers": {
    "address-to-zip": {
      "url": "https://api.example.jp/mcp",
      "headers": { "x-api-key": "YOUR_KEY" }
    }
  }
}

…