Japan postalcode MCP

Suporte ao servidor MCP

API de CEP api-zipcode.jp

A partir do CEP do endereço de entrega, faça a verificação automática se a área é elegível para entrega.
Maximize os lucros sem perder pedidos.
Novo serviço de API de CEP.

Criar conta

Ao criar uma conta, ganhe 1.000 pontos de teste gratuitos.

Sem taxa mensal, de 0,01 iene a 0,05 iene por requisição de API

Pagamento apenas pelo uso, sem custo fixo mensal.

0,05 ienes por requisição

Busca de CEP no servidor MCP

0,01 ienes por requisição

Busca de endereço a partir do CEP

0,03 ienes por requisição

Verificação de área a partir do CEP

0,03 ienes por requisição

Busca de todos os endereços correspondentes a partir de parte do CEP

0,03 ienes por requisição

Busca de todos os CEPs correspondentes a partir de parte do endereço

Um novo formato de API de CEP

Oferecemos uma API simples para implementar buscas complexas de CEP.

Dados de CEP atualizados

Atualização rápida com os dados de CEP mais recentes fornecidos pelo Japan Post.

Suporte a CEPs individuais de empresas

Também oferecemos suporte aos CEPs individuais de empresas fornecidos pelo Japan Post.

Suporte a kana e romaji

Os valores retornados pela API incluem kanji, kana e romaji.

Uso comercial permitido

Uso comercial permitido. Não é necessário crédito ou atribuição.

Verificação de área a partir do CEP

Verifica se um CEP está dentro de uma área específica, como "163-8001 está dentro da região de Shinjuku, Tóquio?"

Busca de endereço a partir do CEP

Busca todos os endereços correspondentes a partir de parte do CEP.

Busca de CEP a partir do endereço

Busca todos os CEPs correspondentes a partir de parte do endereço.

Sistema de recarga por pontos

Faça requisições à API com a compra antecipada de pontos. Sem cobrança mensal. A recarga automática evita a falta de pontos.

Compatível com servidor MCP

Compatível com o Model Context Protocol (MCP), permitindo que assistentes de IA como o Claude realizem buscas de CEP diretamente.

Exemplo de configuração do Claude Desktop
Adicione ao claude_desktop_config.json

{
    "mcpServers": {
        "api-zipcode.jp": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://api-zipcode.jp/mcp/zipcode",
                "--header",
                "Authorization: Bearer ${MCP_TOKEN}"
            ],
            "env": {
                "MCP_TOKEN": "{APIトークン}"
            }
        }
    }
}

Resposta da API

A resposta é retornada em application/json.

Exemplo de resposta

{
    "message": "OK",
    "point": 40725,
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api-zipcode.jp/api/v1/search/zipcode",
        "per_page": 100,
        "to": 1,
        "total": 1
    },
    "links": {
        "first": "https://api-zipcode.jp/api/v1/search/zipcode?zip_code=1006101&page=1",
        "last": "https://api-zipcode.jp/api/v1/search/zipcode?zip_code=1006101&page=1",
        "prev": null,
        "next": null
    },
    "data": [
        {
            "zip_code": "1006101",
            "zip_code_hyphen": "100-6101",
            "prefecture_code": 13,
            "prefecture": "東京都",
            "prefecture_kana": "トウキョウト",
            "prefecture_roman": "TOKYO TO",
            "city": "千代田区",
            "city_kana": "チヨダク",
            "city_roman": "CHIYODA KU",
            "town": "永田町山王パークタワー 1階",
            "town_kana": "ナガタチョウサンノウパークタワー 1カイ",
            "town_roman": "NAGATACHO SANNOPAKUTAWA 1-KAI",
            "block": "",
            "office": "",
            "office_kana": "",
            "address": "東京都千代田区永田町山王パークタワー 1階",
            "address_kana": "トウキョウトチヨダクナガタチョウサンノウパークタワー 1カイ",
            "address_roman": "Nagatacho-Sannopakutawa-1-Kai, Chiyoda-Ku, Tokyo-To, Japan"
        }
    ]
}

Preços

Aceitamos diversos cartões de crédito.
Visa, MasterCard, JCB, Discover, American Express, Diners Club

Valor da recarga (com impostos)	Pontos	Preço por ponto
500 ienes	＋ 50.000 pt	0,01 iene
1.000 ienes	＋ 100.000 pt	0,01 iene
2.000 ienes	＋ 200.000 pt	0,01 iene
3.000 ienes	＋ 330.000 pt	0,0091 iene
5.000 ienes	＋ 600.000 pt	0,0083 iene