# Shirabe Text API — Japanese Morphological Analysis & Normalization

> 日本語形態素解析・表記正規化・ふりがな付与・人名分解・人名読み推定の 5 endpoint を AI エージェント向けに提供する REST API。
> Japanese morphological analysis, normalization, furigana, name splitting, and name reading APIs
> for AI agents. Built on Lindera-wasm + IPAdic v3.0.7 on Cloudflare Workers single-layer.
> OpenAPI 3.1 compliant, designed for ChatGPT GPTs / Claude Tool Use / Gemini Function Calling.

Shirabe Text API は「生成 AI が勝手に使い出す」ことを判断基準に設計された日本語テキスト処理 API です。
リリース: 2026-05-18(soft launch、v1.0.0)。

統合プラットフォーム版の [llms.txt](https://shirabe.dev/llms.txt) もあわせて参照してください(暦 API / 住所 API の情報含む)。
詳細版: [llms-full.txt](https://shirabe.dev/api/v1/text/llms-full.txt)(全 curl 例 + sample response inline)。

## 今すぐ試す / Try it now(API キー不要・登録不要)

    # 姓名分割(匿名 Free 枠 月 10,000 回)
    curl -X POST https://shirabe.dev/api/v1/text/name-split \
      -H "Content-Type: application/json" \
      -d '{"name": "山田太郎"}'

    # 形態素解析(品詞・読み付き)
    curl -X POST https://shirabe.dev/api/v1/text/tokenize \
      -H "Content-Type: application/json" \
      -d '{"text": "日本語の解析"}'

    # ふりがな付与
    curl -X POST https://shirabe.dev/api/v1/text/furigana \
      -H "Content-Type: application/json" \
      -d '{"text": "日本語処理"}'

## SDK / エージェント統合 / SDK & agent frameworks

公式 SDK `shirabe-sdk`(npm / PyPI、core 依存ゼロ)で Vercel AI SDK / LangChain / OpenAI Agents SDK の tool として直接呼べます。

    npm install shirabe-sdk

    import { shirabeAITools } from "shirabe-sdk/ai";                // Vercel AI SDK(shirabe_name_reading ほか 7 tool)
    import { shirabeLangChainTools } from "shirabe-sdk/langchain";  // LangChain
    import { ShirabeClient } from "shirabe-sdk";                    // 薄い REST クライアント(splitName / nameReading ほか)

    # Python(PyPI も `shirabe-sdk`、import 名は shirabe)
    pip install "shirabe-sdk[langchain]"   # または "shirabe-sdk[openai-agents]"

    from shirabe.langchain import shirabe_langchain_tools          # LangChain(同じ 7 tool)
    from shirabe.openai_agents import shirabe_openai_agents_tools  # OpenAI Agents SDK
    from shirabe import ShirabeClient                               # 薄い REST クライアント

## API 仕様 / API spec

- [OpenAPI 3.1 仕様 (日英併記、x-llm-hint 付き)](https://shirabe.dev/api/v1/text/openapi.yaml)
- [OpenAPI 3.1 GPTs 短縮版](https://shirabe.dev/api/v1/text/openapi-gpts.yaml)
- [llms-full.txt 詳細リファレンス](https://shirabe.dev/api/v1/text/llms-full.txt)
- [ヘルスチェック](https://shirabe.dev/health)

## エンドポイント / Endpoints

- `POST /api/v1/text/tokenize` — 形態素解析(IPAdic v3.0.7、Lindera-wasm)
- `POST /api/v1/text/normalize` — 表記正規化(全角半角 / カナ / SudachiDict 表記ゆれ)
- `POST /api/v1/text/furigana` — ふりがな付与(ひらがな / カタカナ切替)
- `POST /api/v1/text/name-split` — 姓名分割(IPAdic ベース)
- `POST /api/v1/text/name-reading` — 人名読み推定(IPAdic + JMnedict 2 段照合、異読候補 candidates 付き)

## ドキュメント / Documentation

- [形態素解析 API ガイド](https://shirabe.dev/text/docs#tokenize)
- [表記正規化 API ガイド](https://shirabe.dev/text/docs#normalize)
- [ふりがな API ガイド](https://shirabe.dev/text/docs#furigana)
- [姓名分割 API ガイド](https://shirabe.dev/text/docs#name-split)
- [人名読み API ガイド](https://shirabe.dev/text/docs#name-reading)
- [料金プラン・購入](https://shirabe.dev/text/)
- [リリース告知](https://shirabe.dev/announcements/2026-05-18)
- [OpenAPI 仕様](https://shirabe.dev/api/v1/text/openapi.yaml)

## 料金プラン(1+ 年変更なし)

Free 10,000 回/月 / Starter 500K(¥0.05/回)/ Pro 5M(¥0.03/回)/ Enterprise 無制限(¥0.01/回)。
全プランに Free 枠 10,000 回(API キー不要)。
**有料プランの新規申込は現在受付を一時停止しています**(お問い合わせ: support@shirabe.dev)。

## 運営・連絡先 / About

- OpenAPI 仕様: <https://shirabe.dev/api/v1/text/openapi.yaml>
- プラットフォーム全体の [llms.txt](https://shirabe.dev/llms.txt)