{"openapi":"3.1.0","info":{"title":"Yahoo Japan Text Analysis (BYOK) API","version":"0.1.0","description":"Yahoo Japan Text Analysis (BYOK) lets an AI assistant read your own Yahoo Japan Text Analysis data through the Yahoo Japan Text Analysis API with a key you supply (Yahoo! JAPAN Developer Network Client ID (application ID)). Read-only: 7 tools (add_furigana, proofread_text, extract_key_phrases, analyze_morphology, parse_dependencies, extract_named_entities, convert_kana_kanji). The BYOK key...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-yahoo-japan-text-analysis.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-yahoo-japan-text-analysis/docs"},"termsOfService":"https://connectorbay.com/byok-yahoo-japan-text-analysis/terms"},"servers":[{"url":"https://byok-yahoo-japan-text-analysis.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-yahoo-japan-text-analysis/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/add_furigana":{"post":{"operationId":"add_furigana","summary":"Add hiragana and romaji readings (furigana) to Japanese text, word by word, optionally only for kanji above a school gra","description":"Add hiragana and romaji readings (furigana) to Japanese text, word by word, optionally only for kanji above a school grade. Use for \"Give the furigana for 漢字かな交じり文にふりがなを振ること。\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Japanese text to annotate.","maxLength":4000,"title":"Q","type":"string"},"grade":{"anyOf":[{"maximum":8,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"School grade 1 to 6 (readings for kanji not yet taught), 7 (junior high and up) or 8 (general); leave empty to annotate all kanji.","title":"Grade"}},"required":["q"],"title":"add_furiganaArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/proofread_text":{"post":{"operationId":"proofread_text","summary":"Proofread Japanese text and list suspected mistakes: wrong conversions, misused words, redundant expressions, with a sug","description":"Proofread Japanese text and list suspected mistakes: wrong conversions, misused words, redundant expressions, with a suggested replacement and the position. Use for \"Proofread the text セキュリティー,食べれる\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Japanese text to check.","maxLength":4000,"title":"Q","type":"string"}},"required":["q"],"title":"proofread_textArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/extract_key_phrases":{"post":{"operationId":"extract_key_phrases","summary":"Extract up to 20 key phrases from Japanese text, each with an importance score up to 100. Use for \"What are the key phra","description":"Extract up to 20 key phrases from Japanese text, each with an importance score up to 100. Use for \"What are the key phrases in 東京ミッドタウンから国立新美術館まで歩いて5分で着きます。\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Japanese text to analyze.","maxLength":4000,"title":"Q","type":"string"}},"required":["q"],"title":"extract_key_phrasesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/analyze_morphology":{"post":{"operationId":"analyze_morphology","summary":"Split Japanese text into morphemes. Each token is a list: surface form, reading, base form, part of speech, subclass, co","description":"Split Japanese text into morphemes. Each token is a list: surface form, reading, base form, part of speech, subclass, conjugation type and form. Use for \"Run morphological analysis on 美しい水車小屋の娘\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Japanese text to analyze.","maxLength":4000,"title":"Q","type":"string"}},"required":["q"],"title":"analyze_morphologyArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/parse_dependencies":{"post":{"operationId":"parse_dependencies","summary":"Parse the dependency structure of one Japanese sentence into chunks with their head chunk and tokens (trial feature of t","description":"Parse the dependency structure of one Japanese sentence into chunks with their head chunk and tokens (trial feature of the vendor). Use for \"Parse the dependencies of 青空にたくさんの気球が浮かんでいた\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"One Japanese sentence.","maxLength":4000,"title":"Q","type":"string"}},"required":["q"],"title":"parse_dependenciesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/extract_named_entities":{"post":{"operationId":"extract_named_entities","summary":"Find named entities in Japanese text (organizations, people, places, artifacts, dates, times, money, percentages) with o","description":"Find named entities in Japanese text (organizations, people, places, artifacts, dates, times, money, percentages) with offset and length. Use for \"Extract the named entities from Xデータ株式会社の加藤さんは、10時に東京駅に到着しました。\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Japanese text to analyze.","maxLength":4000,"title":"Q","type":"string"}},"required":["q"],"title":"extract_named_entitiesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/convert_kana_kanji":{"post":{"operationId":"convert_kana_kanji","summary":"Convert hiragana or romaji into kanji candidates, segment by segment, with the other script forms of each segment. Use f","description":"Convert hiragana or romaji into kanji candidates, segment by segment, with the other script forms of each segment. Use for \"Convert きょうはよいてんきです。 to kanji\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"description":"Text to convert, up to 80 characters in hiragana terms.","maxLength":4000,"title":"Q","type":"string"},"format":{"anyOf":[{"enum":["hiragana","roman"],"type":"string"},{"type":"null"}],"default":null,"description":"Input format: hiragana or roman.","title":"Format"},"mode":{"anyOf":[{"enum":["kanakanji","roman","predictive"],"type":"string"},{"type":"null"}],"default":null,"description":"kanakanji (default), roman (romaji to hiragana only) or predictive.","title":"Mode"},"results":{"anyOf":[{"maximum":999,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Number of candidates per segment (default 999).","title":"Results"}},"required":["q"],"title":"convert_kana_kanjiArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}