@first-ch/tools-mcp 0.32.0 → 0.33.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +4 -2
  2. package/package.json +10 -3
  3. package/server.mjs +37 -0
  4. package/slug.mjs +384 -0
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # @first-ch/tools-mcp
2
2
 
3
- MCP server exposing [First CH Tools](https://tools.first-ch.com)' free web-tool logic — WCAG contrast, JP character/X-weight counting, WebP conversion, JSON-LD generation, llms.txt generation, encoding/line-ending conversion, Marp Markdown→slide rendering, Japanese/English test-data generation, text/code diffing, cron-expression explanation, Base64/data-URI encoding, URL query-parameter editing, HTML entity escaping/unescaping, JSON⇄YAML conversion, px ⇄ rem/em unit conversion, colour-code conversion with alpha compositing, MD5/SHA-1/SHA-256/SHA-384/SHA-512 hashing, JWT decoding with expiry and signature checks, User-Agent parsing with device/bot detection, bulk UUID v4 / ULID generation, aspect-ratio calculation with responsive sizing, case conversion between camelCase, snake_case and kebab-case, CSV/TSV ⇄ JSON conversion, IP/CIDR calculation with subnet splitting and IP-range reduction, business-day date calculation with Japanese public holidays, HTML-to-Markdown conversion, and Japanese era ⇄ Western date conversion with age calculation — to AI agents such as Claude Code.
3
+ MCP server exposing [First CH Tools](https://tools.first-ch.com)' free web-tool logic — WCAG contrast, JP character/X-weight counting, WebP conversion, JSON-LD generation, llms.txt generation, encoding/line-ending conversion, Marp Markdown→slide rendering, Japanese/English test-data generation, text/code diffing, cron-expression explanation, Base64/data-URI encoding, URL query-parameter editing, HTML entity escaping/unescaping, JSON⇄YAML conversion, px ⇄ rem/em unit conversion, colour-code conversion with alpha compositing, MD5/SHA-1/SHA-256/SHA-384/SHA-512 hashing, JWT decoding with expiry and signature checks, User-Agent parsing with device/bot detection, bulk UUID v4 / ULID generation, aspect-ratio calculation with responsive sizing, case conversion between camelCase, snake_case and kebab-case, CSV/TSV ⇄ JSON conversion, IP/CIDR calculation with subnet splitting and IP-range reduction, business-day date calculation with Japanese public holidays, HTML-to-Markdown conversion, Japanese era ⇄ Western date conversion with age calculation, and URL-slug generation from Japanese titles — to AI agents such as Claude Code.
4
4
 
5
5
  日本語版は [後半セクション](#日本語) を参照してください。
6
6
 
@@ -81,6 +81,7 @@ This server is also registered in the [MCP Registry](https://registry.modelconte
81
81
  | `html_to_markdown` | Converts an HTML fragment into Markdown — the same logic as the browser tool at tools.first-ch.com/html-md/. For turning a fetched page into something an LLM can read cheaply, and for moving existing web copy into Markdown. Headings (h1-h6), paragraphs, line breaks, emphasis, strikethrough, lists (nested, the `start` attribute, checkboxes), tables (thead / caption, with column alignment taken from `align` and `text-align`), links, images, code blocks (the language comes from `class="language-*"`), block quotes, horizontal rules, definition lists, figure / figcaption and details / summary are all handled, while `script`, `style`, anything marked `hidden` or `display:none` and presentational `div` / `span` wrappers are removed. **The HTML is not parsed with the browser DOM**: the tokeniser and tree builder are written by hand, so this server and the web page agree exactly, and unclosed elements are closed at the end while stray closing tags are dropped — the counts always come back in `notes`. **An attribute quote that is never closed stops the tag there**, because carrying on would swallow the rest of the document as one attribute value. **Whatever Markdown cannot express is reported rather than dropped in silence**: merged cells (a `colspan` is padded with empty cells, a `rowspan` keeps its value on the first row only), a cell holding a list or a code block (that table is left as HTML), definition lists (written in the Markdown Extra `: ` form) and `sup` / `sub` / `mark` / `iframe` / `svg` (`unknown` chooses between keeping them as HTML, reducing them to text and removing them). Tables, task lists and strikethrough are GFM extensions, so `gfm=false` switches them off. `base_url` rewrites relative links and images as absolute URLs — the thing that breaks most often in a migration — and `main_only` keeps only `main` / `article`, dropping `header`, `nav`, `footer`, `aside` and `form`. It never touches the network; fetching the page is the caller's job | `html?` or `path?`, `outputPath?`, `main_only?`, `base_url?`, `gfm?`, `escape?`, `pad_tables?`, `headings?` (`atx` default / `setext`), `bullet?` (`-` / `*` / `+`), `code_block?` (`fenced` / `indented`), `links?` (`inline` / `reference` / `strip`), `images?` (`keep` / `alt` / `drop`), `tables?` (`gfm` / `html`), `unknown?` (`keep` / `text` / `drop`), `br?` (`spaces` / `backslash` / `html` / `space`), `lang?` (`ja` default / `en`) |
82
82
 
83
83
  | `wareki_convert` | Converts Japanese era dates (Reiwa, Heisei, Showa, Taisho, Meiji) and Western dates both ways and returns the weekday and zodiac — the same logic as the browser tool at tools.first-ch.com/wareki/. For converting and checking the dates in contracts, invoices and official forms. `mode="convert"` takes `date` or `dates` (up to 1000) and **detects which calendar each one is in**: `2026-10-01`, `2026/10/1`, `20261001`, `2026年10月1日`, `令和8年10月1日`, `R8.10.1`, `令和八年十月一日`, `㋿8.10.1`, `Reiwa 8` and so on. A year alone (`1989`, `昭和64年`) or a year and month (`2019-05`) also works, and both eras are returned when the period spans an era change. `formats` gives the era date (gannen, with weekday, in kanji numerals), the short forms (`R8.10.1` / `R08.10.01`), Western, ISO 8601 and English. Eras begin on 1912-07-30 (Taisho), 1926-12-25 (Showa), 1989-01-08 (Heisei) and 2019-05-01 (Reiwa). **Era dates that never existed (Heisei 32, Heisei 31 May 1, Reiwa 1 April 30) are still converted, and `notes` gives the correct era date**; a written weekday that does not match comes back as `WEEKDAY_MISMATCH`. **Before 1873 (Meiji 5 and earlier) only the year is converted**, because dates were lunisolar (`LUNAR_CALENDAR`). `mode="age"` takes `birth` (era dates accepted) and `reference` (today in Japan time if omitted) and returns the exact age (it goes up on the birthday; people born on February 29 turn older on March 1 in common years), years/months/days, the kazoe age, the next birthday and the entry and graduation years from elementary school to university. `mode="eras"` returns the era list, plus a year chart of era, zodiac and age when `from_year` / `to_year` are given (up to 500 years). Badly written dates come back as `ok: false` with `error.code` | `mode?` (`convert` / `age` / `eras`), `date?`, `dates?`, `birth?`, `reference?`, `from_year?`, `to_year?`, `lang?` (`ja` default / `en`) |
84
+ | `slug_generate` | Builds a URL slug for WordPress and other CMSs from a Japanese title — the same logic as the browser tool at tools.first-ch.com/slug/. Kana are written in Hepburn romaji (`し→shi`, `ち→chi`, `つ→tsu`, `ふ→fu`, `じ→ji`, `しゃ→sha`, a small っ doubles the consonant as in `kitte` / `matcha`, `ん` is always `n`, `ファ→fa`, `ティ→ti`, `ヴァ→va`), symbols are removed and the words are joined with hyphens (or underscores with `separator="snake"`) and lowercased, so the result is only `a-z`, `0-9` and the separator. **Kanji readings are not guessed**: pass the reading in kana as `reading` and the slug is built from it instead of `title` (spaces in `reading` become separators: `とうきょう で たべた ラーメン 10せん` → `tokyo-de-tabeta-ramen-10-sen`). Kanji left without a reading are skipped and reported in `skipped` and a `KANJI` note. Words also split at symbols, kanji, kana ⇄ Latin/digit changes and (with `splitKatakana`, the default) hiragana ⇄ katakana changes. `longVowel="omit"` (default) collapses ou/oo/uu and ー (`tokyo`, `ramen`; ei and ii stay), `"keep"` spells them out (`toukyou`, `raamen`). The particles は・へ・を come out as spelled (`ha`, `he`, `o`). `maxLength` cuts at a word boundary. Digits-only slugs (which can clash with date archives so WordPress may append `-2`) and slugs over 60 characters are flagged. `variants` gives all four separator × long-vowel spellings, and `items` builds up to 1000 slugs at once with a `DUPLICATE` note for collisions | `title?`, `reading?`, `items?` (strings or `{title, reading}`), `separator?` (`kebab` default / `snake`), `longVowel?` (`omit` default / `keep`), `maxLength?` (0–200, 0 = no limit), `splitKatakana?`, `lang?` (`ja` default / `en`) |
84
85
 
85
86
  See [`server.mjs`](./server.mjs) for the exact Zod input schemas.
86
87
 
@@ -125,7 +126,7 @@ Release rule: a push to `main` automatically publishes a new package version thr
125
126
 
126
127
  ## 日本語
127
128
 
128
- `@first-ch/tools-mcp` は、[First CH Tools](https://tools.first-ch.com)(無料Webツール集)の計算ロジック — WCAGコントラスト比・日本語文字数/Xウェイト計測・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/編集/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4 / ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・camelCase / snake_case / kebab-case などの文字列ケース変換・CSV/TSV ⇄ JSON の相互変換・日数/営業日の計算(日本の祝日を内蔵)・HTML→Markdownの変換・和暦⇄西暦の変換と満年齢の計算 — をAIエージェント(Claude Code等)向けMCPツールとして提供するサーバーです。
129
+ `@first-ch/tools-mcp` は、[First CH Tools](https://tools.first-ch.com)(無料Webツール集)の計算ロジック — WCAGコントラスト比・日本語文字数/Xウェイト計測・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/編集/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4 / ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・camelCase / snake_case / kebab-case などの文字列ケース変換・CSV/TSV ⇄ JSON の相互変換・日数/営業日の計算(日本の祝日を内蔵)・HTML→Markdownの変換・和暦⇄西暦の変換と満年齢の計算・日本語タイトルからのURLスラッグ生成 — をAIエージェント(Claude Code等)向けMCPツールとして提供するサーバーです。
129
130
 
130
131
  ### インストール
131
132
 
@@ -204,6 +205,7 @@ claude mcp add firstch-tools -- npx -y @first-ch/tools-mcp
204
205
  | `html_to_markdown` | HTML断片をMarkdownへ変換する。tools.first-ch.com/html-md/ と同一ロジック。取得したページの本文をLLMへ渡す前の後処理、既存サイトの原稿をMarkdown管理へ移す移行作業のための道具。見出し(h1〜h6)・段落・改行・強調・取り消し線・リスト(入れ子・`start` 属性・チェックボックス)・表(thead / caption と `align`・`text-align` による列の配置)・リンク・画像・コードブロック(`class="language-*"` から言語を拾う)・引用・水平線・定義リスト・figure / figcaption・details / summary に対応し、`script`・`style`・`hidden` や `display:none` の要素・装飾のための `div` / `span` は自動で取り除く。**HTMLの解釈にブラウザのDOMを使っていない**——字句解析も木の組み立ても自前なのでWeb版と結果が一致し、閉じ忘れたタグは末尾で閉じ、行き場のない閉じタグは捨てて変換を続ける(補った件数は必ず `notes` で返す)。**属性の引用符が閉じていない場合だけは打ち切る**——続けると残りの文書全体を1つの属性値として飲み込むため。**Markdownに書けないものは黙って捨てず報告する**: セルの結合(`colspan` は空セルで埋め、`rowspan` は先頭行にだけ値が入る)・セル内のリスト/コードブロック(その表だけHTMLのまま残す)・定義リスト(Markdown Extra の `: ` 記法)・`sup` / `sub` / `mark` / `iframe` / `svg`(`unknown` で「HTMLのまま残す/文字だけ残す/取り除く」を選ぶ)。表・タスクリスト・取り消し線はGFMの拡張なので `gfm=false` で切れる。`base_url` を渡すと相対URLのリンクと画像を絶対URLへ直し(移行でいちばん壊れるところ)、`main_only=true` は `main` / `article` の中だけを取り出して `header`・`nav`・`footer`・`aside`・`form` を落とす。ネットワークへは出ない(ページの取得は呼び出し側の仕事) | `html?` または `path?`、`outputPath?`、`main_only?`、`base_url?`、`gfm?`、`escape?`、`pad_tables?`、`headings?`(既定 `atx` / `setext`)、`bullet?`(`-` / `*` / `+`)、`code_block?`(`fenced` / `indented`)、`links?`(`inline` / `reference` / `strip`)、`images?`(`keep` / `alt` / `drop`)、`tables?`(`gfm` / `html`)、`unknown?`(`keep` / `text` / `drop`)、`br?`(`spaces` / `backslash` / `html` / `space`)、`lang?`(既定 `ja` / `en`) |
205
206
 
206
207
  | `wareki_convert` | 和暦(令和・平成・昭和・大正・明治)と西暦を相互に変換し、曜日と干支を返す。tools.first-ch.com/wareki/ と同一ロジック。契約書・請求書・行政書類の日付の変換と検算のための道具。`mode="convert"` は `date` か `dates`(1000件まで)を受け、**西暦か和暦かを自動で見分ける**(`2026-10-01`・`2026/10/1`・`20261001`・`2026年10月1日`・`令和8年10月1日`・`R8.10.1`・`令和八年十月一日`・`㋿8.10.1`・`Reiwa 8` など)。年だけ(`1989`・`昭和64年`)・年月だけ(`2019-05`)も変換でき、改元をまたぐときは両方の元号を返す。`formats` に和暦(元年表記・曜日つき・漢数字)・略記(`R8.10.1`/`R08.10.01`)・西暦・ISO 8601・英語を返す。**存在しない和暦(平成32年・平成31年5月1日・令和元年4月30日)も西暦へ直したうえで正しい和暦を `notes` で指摘**し、書き添えの曜日が実際と違えば `WEEKDAY_MISMATCH` を返す。**明治5年(1872年)以前は旧暦のため年単位でだけ換算する**(`LUNAR_CALENDAR`)。`mode="age"` は `birth`(和暦可)と `reference`(省略時は日本時間の今日)から満年齢(誕生日に1つ増え、2月29日生まれは平年だと3月1日)・年月日の内訳・数え年・次の誕生日と、小学校〜大学の入学・卒業の年を返す。`mode="eras"` は元号一覧を返し、`from_year` / `to_year` を渡すと和暦・干支・満年齢の早見表も返す(500年分まで)。日付の書き方の誤りは `ok: false` と `error.code` で返す | `mode?`(`convert` / `age` / `eras`)、`date?`、`dates?`、`birth?`、`reference?`、`from_year?`、`to_year?`、`lang?`(既定 `ja` / `en`) |
208
+ | `slug_generate` | 日本語の記事タイトルから WordPress 等の URL スラッグを作る。tools.first-ch.com/slug/ と同一ロジック。かなをヘボン式ローマ字にし(`し→shi`・`ち→chi`・`つ→tsu`・`ふ→fu`・`じ→ji`・`しゃ→sha`・促音は子音を重ねて `kitte`/ch の前は `matcha`・`ん` は常に `n`・`ファ→fa`・`ティ→ti`・`ヴァ→va`)、記号を除いてハイフン(`separator="snake"` ならアンダースコア)でつなぎ小文字にする。結果は `a-z`・`0-9`・区切り文字だけ。**漢字の読みは推定しない**: `reading` にかなで読みを渡すと `title` の代わりにそこから作る(`reading` の空白が区切りになる: `とうきょう で たべた ラーメン 10せん` → `tokyo-de-tabeta-ramen-10-sen`)。読みの無い漢字は飛ばして `skipped` と `KANJI` の指摘で返す。区切りは記号・漢字・かな⇄英数字の切り替わりと、`splitKatakana`(既定 true)ならひらがな⇄カタカナの切り替わり。`longVowel="omit"`(既定)は おう・おお・うう と ー を1字にし(`tokyo`・`ramen`。えい・いい は残す)、`"keep"` は `toukyou`・`raamen`。助詞の は・へ・を は字のとおり `ha`・`he`・`o`。`maxLength` は語の切れ目で切る。数字だけのスラッグ(日付アーカイブと衝突し WordPress が `-2` を付けうる)と60文字超を指摘する。`variants` に区切り×長音の4通り、`items` で1000件まで一括・同じスラッグの衝突を `DUPLICATE` で指摘 | `title?`、`reading?`、`items?`(文字列か `{title, reading}`)、`separator?`(既定 `kebab` / `snake`)、`longVowel?`(既定 `omit` / `keep`)、`maxLength?`(0〜200・0=無制限)、`splitKatakana?`、`lang?`(既定 `ja` / `en`) |
207
209
 
208
210
  正確な入力スキーマ(Zod定義)は [`server.mjs`](./server.mjs) を参照してください。
209
211
 
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@first-ch/tools-mcp",
3
- "version": "0.32.0",
4
- "description": "First CH Tools の計算ロジック(WCAGコントラスト比・文字数/Xウェイト・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4/ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・TSV/CSVからMarkdownテーブルへの整形と相互変換・SQLクエリの整形と予約語の大文字化・URL/テキストからのQRコード生成・UNIXタイムスタンプと日時表記の相互変換・robots.txtの生成(AIクローラーの許可プリセット付き)・文字列のケース変換(camelCase/snake_case/kebab-case など11形式)・CSV/TSVとJSON配列の相互変換(区切りの自動判定・a.b 列と入れ子の相互展開)・全角⇄半角の変換とテキストの掃除(文字種ごとの向き指定・半角カナの合成/分解・空白と空行の整理)・IPアドレス/CIDRの計算(ネットワーク・ブロードキャスト・ホスト範囲とホスト数・IPv4/IPv6・サブネット分割・包含判定・IP範囲→最小CIDR集合の逆算)・日数/営業日の計算(2日付間の日数と営業日数・起点日+N日/N営業日の期日・締め日と支払サイトからの支払日・土日と日本の祝日を内蔵)・HTML→Markdownの変換(見出し/リスト/表/リンク/画像/コード・script/styleや装飾タグの除去・本文だけの抽出・相対URLの絶対化)・和暦⇄西暦の変換(令和〜明治・自動判定・曜日と干支・存在しない和暦の指摘・満年齢と入学/卒業の年・元号一覧と早見表))をMCPツールとして提供するサーバー",
3
+ "version": "0.33.0",
4
+ "description": "First CH Tools の計算ロジック(WCAGコントラスト比・文字数/Xウェイト・WebP変換・JSON-LD生成・llms.txt生成・文字コード/改行コード変換・Marp Markdown→スライド レンダリング・テストデータ生成・テキスト/コード差分・Cron式の解説・Base64/Data URI変換・URLパラメータの分解/再構築・HTML特殊文字のエスケープ/エンティティのデコード・JSON⇄YAMLの相互変換・px⇄rem/emの単位換算とCSSの一括変換・カラーコードの相互変換とアルファ透過の合成・MD5/SHA-1/SHA-256/SHA-384/SHA-512のハッシュ生成と照合・JWTのデコードと有効期限/署名の検証・User-Agent文字列の解析とデバイス判定・UUID v4/ULIDの一括生成・アスペクト比の計算とレスポンシブサイズの算出・TSV/CSVからMarkdownテーブルへの整形と相互変換・SQLクエリの整形と予約語の大文字化・URL/テキストからのQRコード生成・UNIXタイムスタンプと日時表記の相互変換・robots.txtの生成(AIクローラーの許可プリセット付き)・文字列のケース変換(camelCase/snake_case/kebab-case など11形式)・CSV/TSVとJSON配列の相互変換(区切りの自動判定・a.b 列と入れ子の相互展開)・全角⇄半角の変換とテキストの掃除(文字種ごとの向き指定・半角カナの合成/分解・空白と空行の整理)・IPアドレス/CIDRの計算(ネットワーク・ブロードキャスト・ホスト範囲とホスト数・IPv4/IPv6・サブネット分割・包含判定・IP範囲→最小CIDR集合の逆算)・日数/営業日の計算(2日付間の日数と営業日数・起点日+N日/N営業日の期日・締め日と支払サイトからの支払日・土日と日本の祝日を内蔵)・HTML→Markdownの変換(見出し/リスト/表/リンク/画像/コード・script/styleや装飾タグの除去・本文だけの抽出・相対URLの絶対化)・和暦⇄西暦の変換(令和〜明治・自動判定・曜日と干支・存在しない和暦の指摘・満年齢と入学/卒業の年・元号一覧と早見表)・日本語タイトルからのURLスラッグ生成(かな→ヘボン式ローマ字・記号除去・ハイフン/アンダースコア連結・小文字化・長音の省略/表記))をMCPツールとして提供するサーバー",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "firstch-tools-mcp": "server.mjs"
@@ -186,7 +186,13 @@
186
186
  "reiwa",
187
187
  "heisei",
188
188
  "showa",
189
- "age-calculator"
189
+ "age-calculator",
190
+ "slug",
191
+ "slugify",
192
+ "romaji",
193
+ "hepburn",
194
+ "permalink",
195
+ "wordpress-slug"
190
196
  ],
191
197
  "author": "First CH LLC (https://first-ch.com)",
192
198
  "homepage": "https://tools.first-ch.com",
@@ -235,6 +241,7 @@
235
241
  "date-calc.mjs",
236
242
  "html-md.mjs",
237
243
  "wareki.mjs",
244
+ "slug.mjs",
238
245
  "date-holidays.json",
239
246
  "vendor/",
240
247
  "README.md",
package/server.mjs CHANGED
@@ -35,6 +35,7 @@ import { cidrCalcTool } from './cidr.mjs';
35
35
  import { dateCalcTool } from './date-calc.mjs';
36
36
  import { htmlToMarkdownTool } from './html-md.mjs';
37
37
  import { warekiConvertTool } from './wareki.mjs';
38
+ import { slugGenerateTool } from './slug.mjs';
38
39
 
39
40
  const { version } = createRequire(import.meta.url)('./package.json');
40
41
  const server = new McpServer({ name: 'firstch-tools', version });
@@ -1516,4 +1517,40 @@ server.registerTool(
1516
1517
  },
1517
1518
  );
1518
1519
 
1520
+ server.registerTool(
1521
+ 'slug_generate',
1522
+ {
1523
+ title: 'URLスラッグ生成(日本語タイトル→ローマ字)',
1524
+ description:
1525
+ '日本語の記事タイトルから WordPress 等の URL スラッグを作る(tools.first-ch.com/slug/ と同一ロジック)。' +
1526
+ 'かなをヘボン式ローマ字にし(し→shi・ち→chi・つ→tsu・ふ→fu・じ→ji・しゃ→sha・促音は子音を重ねて kitte/ch の前は matcha・ん は常に n・ファ→fa・ティ→ti・ヴァ→va)、' +
1527
+ '記号を除いてハイフン(separator="snake" ならアンダースコア)でつなぎ、小文字にする。結果は a-z・0-9・区切り文字だけ。' +
1528
+ '**漢字の読みは推定しない**: reading にかなで読みを渡すと、title の代わりに reading から作る(読みは呼び出し側=AIが決める)。' +
1529
+ 'reading の空白は区切りになるので語の切れ目で空ける("とうきょう で たべた ラーメン 10せん" → tokyo-de-tabeta-ramen-10-sen)。' +
1530
+ 'reading なしで漢字が残ると漢字を飛ばして作り、飛ばした字を skipped と notes(KANJI) で返す。' +
1531
+ '区切りは空白・記号・漢字・かな⇄英数字の切り替わり(splitKatakana=true〔既定〕ならひらがな⇄カタカナの切り替わりも)。' +
1532
+ 'longVowel="omit"(既定)は「おう・おお・うう」と長音記号ーを1字にする(とうきょう→tokyo・ラーメン→ramen。えい・いい は残す)、"keep" は toukyou・raamen。' +
1533
+ '助詞の は・へ・を は字のとおり ha・he・o。半角カナ・全角英数字はそろえ、アクセント記号は外す(Café→cafe)。' +
1534
+ 'maxLength で上限(語の切れ目で切る)。数字だけのスラッグ(日付アーカイブと衝突し WordPress が -2 を付けうる)と60文字超を notes で指摘。' +
1535
+ '区切り×長音の4通りを variants で返す。items で1000件までまとめて作れ、同じスラッグになる項目を DUPLICATE で指摘する。完全ローカル処理・ネットワーク送信なし。',
1536
+ inputSchema: {
1537
+ title: z.string().optional().describe('記事・ページのタイトル(items と排他)'),
1538
+ reading: z.string().optional().describe('読み(漢字をかなに直したもの。空白が区切りになる)。渡すと title の代わりにこちらから作る'),
1539
+ items: z
1540
+ .array(z.union([z.string(), z.object({ title: z.string().optional(), reading: z.string().optional() })]))
1541
+ .optional()
1542
+ .describe('まとめて作る(1000件まで)。文字列か {title, reading}'),
1543
+ separator: z.enum(['kebab', 'snake']).optional().describe("区切り(既定 'kebab'=ハイフン / 'snake'=アンダースコア)"),
1544
+ longVowel: z.enum(['omit', 'keep']).optional().describe("長音(既定 'omit'=tokyo / 'keep'=toukyou)"),
1545
+ maxLength: z.number().int().optional().describe('文字数の上限(0〜200・既定 0=無制限)。語の切れ目で切る'),
1546
+ splitKatakana: z.boolean().optional().describe('ひらがなとカタカナの境目でも区切る(既定 true)'),
1547
+ lang: z.enum(['ja', 'en']).optional().describe("指摘事項の言語(既定 'ja')"),
1548
+ },
1549
+ },
1550
+ async (opts) => {
1551
+ await logUsage('slug_generate');
1552
+ return asText(await slugGenerateTool(opts));
1553
+ },
1554
+ );
1555
+
1519
1556
  await server.connect(new StdioServerTransport());
package/slug.mjs ADDED
@@ -0,0 +1,384 @@
1
+ /* URLスラッグ生成(slug_generate)
2
+ * 生成コア(kanaToRomaji / slugTokens / slugGenerate)は
3
+ * FirstCHTools の site/slug/app.js と同一
4
+ * (2箇所ルール: site側が正本・片方を直したらもう片方も同じ内容で反映する)。
5
+ * 両ファイルからコアの開始/終了コメントに挟まれた範囲を sed で切り出し
6
+ * (site側は字下げ2文字を落とす・こちらは行頭の export を落とす)、
7
+ * diff が空になることで同期を機械的に確認できる。
8
+ *
9
+ * 漢字の読みは推定しない(形態素解析の辞書を積まない)。読みは呼び出し側が reading で渡す。
10
+ * 完全ローカル処理・ネットワーク送信なし。 */
11
+
12
+ /* ==================== ここからスラッグ生成コア(site / MCP で同一) ==================== */
13
+
14
+ // 区切り文字。kebab が WordPress の既定(sanitize_title もハイフンでつなぐ)
15
+ export const SLUG_SEPARATORS = { kebab: '-', snake: '_' };
16
+
17
+ // 長音の書き方。omit=とうきょう→tokyo(パスポート・駅名標の書き方)、keep=toukyou
18
+ export const SLUG_LONG_VOWELS = ['omit', 'keep'];
19
+
20
+ // かな1文字 → ヘボン式。カタカナはひらがなへ寄せてから引く
21
+ export const KANA_SINGLE = {
22
+ 'あ': 'a', 'い': 'i', 'う': 'u', 'え': 'e', 'お': 'o',
23
+ 'か': 'ka', 'き': 'ki', 'く': 'ku', 'け': 'ke', 'こ': 'ko',
24
+ 'が': 'ga', 'ぎ': 'gi', 'ぐ': 'gu', 'げ': 'ge', 'ご': 'go',
25
+ 'さ': 'sa', 'し': 'shi', 'す': 'su', 'せ': 'se', 'そ': 'so',
26
+ 'ざ': 'za', 'じ': 'ji', 'ず': 'zu', 'ぜ': 'ze', 'ぞ': 'zo',
27
+ 'た': 'ta', 'ち': 'chi', 'つ': 'tsu', 'て': 'te', 'と': 'to',
28
+ 'だ': 'da', 'ぢ': 'ji', 'づ': 'zu', 'で': 'de', 'ど': 'do',
29
+ 'な': 'na', 'に': 'ni', 'ぬ': 'nu', 'ね': 'ne', 'の': 'no',
30
+ 'は': 'ha', 'ひ': 'hi', 'ふ': 'fu', 'へ': 'he', 'ほ': 'ho',
31
+ 'ば': 'ba', 'び': 'bi', 'ぶ': 'bu', 'べ': 'be', 'ぼ': 'bo',
32
+ 'ぱ': 'pa', 'ぴ': 'pi', 'ぷ': 'pu', 'ぺ': 'pe', 'ぽ': 'po',
33
+ 'ま': 'ma', 'み': 'mi', 'む': 'mu', 'め': 'me', 'も': 'mo',
34
+ 'や': 'ya', 'ゆ': 'yu', 'よ': 'yo',
35
+ 'ら': 'ra', 'り': 'ri', 'る': 'ru', 'れ': 're', 'ろ': 'ro',
36
+ 'わ': 'wa', 'ゐ': 'i', 'ゑ': 'e', 'を': 'o', 'ん': 'n',
37
+ 'ぁ': 'a', 'ぃ': 'i', 'ぅ': 'u', 'ぇ': 'e', 'ぉ': 'o',
38
+ 'ゃ': 'ya', 'ゅ': 'yu', 'ょ': 'yo', 'ゎ': 'wa',
39
+ 'ゔ': 'vu', 'ゕ': 'ka', 'ゖ': 'ke',
40
+ };
41
+
42
+ // 2文字で1音になる組(拗音と外来音)
43
+ export const KANA_PAIRS = (() => {
44
+ const pairs = {};
45
+ // イ段+ゃゅょ: きゃ kya / しゃ sha / ちゃ cha / じゃ ja
46
+ const yoon = {
47
+ 'き': 'ky', 'ぎ': 'gy', 'し': 'sh', 'じ': 'j', 'ち': 'ch', 'ぢ': 'j', 'に': 'ny',
48
+ 'ひ': 'hy', 'び': 'by', 'ぴ': 'py', 'み': 'my', 'り': 'ry',
49
+ };
50
+ for (const k of Object.keys(yoon)) {
51
+ pairs[k + 'ゃ'] = yoon[k] + 'a';
52
+ pairs[k + 'ゅ'] = yoon[k] + 'u';
53
+ pairs[k + 'ょ'] = yoon[k] + 'o';
54
+ }
55
+ const extra = {
56
+ 'しぇ': 'she', 'じぇ': 'je', 'ちぇ': 'che', 'いぇ': 'ye',
57
+ 'ふぁ': 'fa', 'ふぃ': 'fi', 'ふぇ': 'fe', 'ふぉ': 'fo', 'ふゅ': 'fyu',
58
+ 'てぃ': 'ti', 'でぃ': 'di', 'てゅ': 'tyu', 'でゅ': 'dyu', 'とぅ': 'tu', 'どぅ': 'du',
59
+ 'うぃ': 'wi', 'うぇ': 'we', 'うぉ': 'wo',
60
+ 'ゔぁ': 'va', 'ゔぃ': 'vi', 'ゔぇ': 've', 'ゔぉ': 'vo', 'ゔゅ': 'vyu',
61
+ 'つぁ': 'tsa', 'つぃ': 'tsi', 'つぇ': 'tse', 'つぉ': 'tso',
62
+ 'くぁ': 'kwa', 'くぃ': 'kwi', 'くぇ': 'kwe', 'くぉ': 'kwo', 'ぐぁ': 'gwa',
63
+ 'すぃ': 'si', 'ずぃ': 'zi',
64
+ };
65
+ for (const k of Object.keys(extra)) pairs[k] = extra[k];
66
+ return pairs;
67
+ })();
68
+
69
+ // ヷヸヹヺ はひらがなに対応する字が無いので、先に ゔ+小書きへ開く
70
+ const KATA_WIDE_V = { 'ヷ': 'ゔぁ', 'ヸ': 'ゔぃ', 'ヹ': 'ゔぇ', 'ヺ': 'ゔぉ' };
71
+
72
+ // ラテン文字のうち、NFD で分解しても ASCII にならないもの
73
+ const LATIN_FOLD = { 'ß': 'ss', 'æ': 'ae', 'Æ': 'AE', 'ø': 'o', 'Ø': 'O', 'œ': 'oe', 'Œ': 'OE', 'đ': 'd', 'Đ': 'D', 'ł': 'l', 'Ł': 'L', 'ı': 'i', 'þ': 'th', 'Þ': 'TH', 'ð': 'd', 'Ð': 'D' };
74
+
75
+ const isHira = (c) => (c >= 'ぁ' && c <= 'ゖ') || c === 'ゝ' || c === 'ゞ';
76
+ const isKata = (c) => (c >= 'ァ' && c <= 'ヺ') || c === 'ヽ' || c === 'ヾ';
77
+
78
+ /**
79
+ * かなの並びをヘボン式ローマ字にする(小文字・区切りなし)。
80
+ * っ は次の子音を重ね(ch の前は t)、ー と長音は longVowel に従う。
81
+ * @param {string} kana ひらがな・カタカナ(ー を含んでよい)
82
+ * @param {'omit'|'keep'} [longVowel='omit']
83
+ */
84
+ export function kanaToRomaji(kana, longVowel) {
85
+ const keep = longVowel === 'keep';
86
+ let hira = '';
87
+ for (const ch of String(kana)) {
88
+ if (KATA_WIDE_V[ch]) hira += KATA_WIDE_V[ch];
89
+ else if (ch >= 'ァ' && ch <= 'ヶ') hira += String.fromCharCode(ch.charCodeAt(0) - 0x60);
90
+ else hira += ch;
91
+ }
92
+ const chars = [...hira];
93
+ const units = [];
94
+ for (let i = 0; i < chars.length; i += 1) {
95
+ const pair = chars[i] + (chars[i + 1] || '');
96
+ if (KANA_PAIRS[pair]) {
97
+ units.push({ k: pair, r: KANA_PAIRS[pair] });
98
+ i += 1;
99
+ } else if (chars[i] === 'っ' || chars[i] === 'ー') {
100
+ units.push({ k: chars[i], r: '' });
101
+ } else if (KANA_SINGLE[chars[i]] !== undefined) {
102
+ units.push({ k: chars[i], r: KANA_SINGLE[chars[i]] });
103
+ }
104
+ }
105
+ let out = '';
106
+ let geminate = false;
107
+ let lastVowel = '';
108
+ for (const u of units) {
109
+ if (u.k === 'っ') {
110
+ geminate = true;
111
+ continue;
112
+ }
113
+ if (u.k === 'ー') {
114
+ // 長音記号: 書くなら直前の母音を重ねる(らーめん → raamen)。省くなら何も足さない
115
+ if (keep && lastVowel) out += lastVowel;
116
+ geminate = false;
117
+ continue;
118
+ }
119
+ // 省く書き方では「おう・おお・うう」を1字にする(とうきょう → tokyo、おおさか → osaka)。
120
+ // え段+い(えい)とあ段・い段の重なりは残す(パスポートのヘボン式と同じ扱い)
121
+ if (!keep && !geminate && ((u.k === 'う' && (lastVowel === 'o' || lastVowel === 'u')) || (u.k === 'お' && lastVowel === 'o'))) {
122
+ continue;
123
+ }
124
+ let r = u.r;
125
+ if (geminate) {
126
+ // 促音: 次の子音を重ねる。ch の前だけは t(まっちゃ → matcha)。母音の前や末尾では消える
127
+ if (/^[bcdfghjkmpqrstvwyz]/.test(r)) r = (r.startsWith('ch') ? 't' : r[0]) + r;
128
+ geminate = false;
129
+ }
130
+ out += r;
131
+ lastVowel = /[aiueo]$/.test(r) ? r.slice(-1) : '';
132
+ }
133
+ return out;
134
+ }
135
+
136
+ /**
137
+ * 文字列を語に割る。区切りになるのは空白・記号・漢字・その他の文字と、
138
+ * かな ⇄ 英数字の切り替わり(splitKatakana なら ひらがな ⇄ カタカナ の切り替わりも)。
139
+ * @returns {{words: {type:'kana'|'alnum', text:string}[], kanji: string[], other: string[]}}
140
+ */
141
+ export function slugTokens(src, splitKatakana) {
142
+ const s = String(src).normalize('NFKC');
143
+ const words = [];
144
+ const kanji = [];
145
+ const other = [];
146
+ let cur = null;
147
+ const flush = () => {
148
+ if (cur && cur.text) words.push({ type: cur.type, text: cur.text });
149
+ cur = null;
150
+ };
151
+ const addKana = (ch, script) => {
152
+ if (!cur || cur.type !== 'kana' || (splitKatakana && cur.script !== script)) {
153
+ flush();
154
+ cur = { type: 'kana', script, text: '' };
155
+ }
156
+ cur.text += ch;
157
+ cur.last = ch;
158
+ };
159
+ for (let ch of s) {
160
+ // 踊り字(ゝゞヽヾ)は直前のかなに開く。ゞ・ヾ は濁らせる
161
+ if (ch === 'ゝ' || ch === 'ゞ' || ch === 'ヽ' || ch === 'ヾ') {
162
+ if (!cur || cur.type !== 'kana' || !cur.last || cur.last === 'ー') {
163
+ flush();
164
+ continue;
165
+ }
166
+ const base = cur.last.normalize('NFD')[0];
167
+ const voiced = (base + '゙').normalize('NFC');
168
+ ch = ch === 'ゞ' || ch === 'ヾ' ? (voiced.length === 1 ? voiced : base) : base;
169
+ addKana(ch, cur.script);
170
+ continue;
171
+ }
172
+ if (ch === 'ー') {
173
+ // 長音記号は直前がかなのときだけ語の一部(単独の「ーー」は飾りの線とみなす)
174
+ if (cur && cur.type === 'kana') addKana(ch, cur.script);
175
+ else flush();
176
+ continue;
177
+ }
178
+ if (isHira(ch)) {
179
+ addKana(ch, 'hira');
180
+ continue;
181
+ }
182
+ if (isKata(ch) && ch !== '・') {
183
+ addKana(ch, 'kata');
184
+ continue;
185
+ }
186
+ // ラテン文字は ASCII へ畳む(é → e、ß → ss)
187
+ if (/\p{Script=Latin}/u.test(ch) && !/[A-Za-z]/.test(ch)) {
188
+ ch = LATIN_FOLD[ch] || ch.normalize('NFD').replace(/\p{M}/gu, '');
189
+ }
190
+ if (/^[A-Za-z0-9]+$/.test(ch)) {
191
+ if (!cur || cur.type !== 'alnum') {
192
+ flush();
193
+ cur = { type: 'alnum', text: '' };
194
+ }
195
+ cur.text += ch;
196
+ continue;
197
+ }
198
+ // 英単語の中のアポストロフィは区切らずに落とす(Don't → dont)
199
+ if (/^['’‘ʼ]$/.test(ch) && cur && cur.type === 'alnum') continue;
200
+ flush();
201
+ if (/[\p{Script=Han}々〆〇]/u.test(ch)) {
202
+ if (kanji.indexOf(ch) === -1) kanji.push(ch);
203
+ } else if (/\p{L}/u.test(ch)) {
204
+ if (other.indexOf(ch) === -1) other.push(ch);
205
+ }
206
+ }
207
+ flush();
208
+ return { words, kanji, other };
209
+ }
210
+
211
+ /**
212
+ * タイトル(または読み)からURLスラッグを作る。
213
+ *
214
+ * @param {object} opts
215
+ * @param {string} opts.title タイトル
216
+ * @param {string} [opts.reading] 読み。空でなければタイトルの代わりにこちらから作る(漢字をかなに直したもの)
217
+ * @param {'kebab'|'snake'} [opts.separator='kebab']
218
+ * @param {'omit'|'keep'} [opts.longVowel='omit']
219
+ * @param {boolean} [opts.splitKatakana=true] ひらがなとカタカナの境目でも区切る
220
+ * @param {number} [opts.maxLength=0] 上限の文字数(0=無制限)。語の切れ目で切る
221
+ * @returns {{slug,source,separator,longVowel,romaji,words,length,kanji,other,notes}}
222
+ */
223
+ export function slugGenerate(opts) {
224
+ const o = opts || {};
225
+ const separator = o.separator === 'snake' ? 'snake' : 'kebab';
226
+ const longVowel = o.longVowel === 'keep' ? 'keep' : 'omit';
227
+ const splitKatakana = o.splitKatakana !== false;
228
+ const maxLength = Number.isInteger(o.maxLength) && o.maxLength > 0 ? o.maxLength : 0;
229
+ const title = typeof o.title === 'string' ? o.title : '';
230
+ const reading = typeof o.reading === 'string' ? o.reading : '';
231
+ const useReading = reading.trim() !== '';
232
+ const src = useReading ? reading : title;
233
+ const sep = SLUG_SEPARATORS[separator];
234
+
235
+ const t = slugTokens(src, splitKatakana);
236
+ const words = t.words
237
+ .map((w) => ({ input: w.text, type: w.type, output: w.type === 'kana' ? kanaToRomaji(w.text, longVowel) : w.text.toLowerCase() }))
238
+ .filter((w) => w.output);
239
+ const parts = words.map((w) => w.output);
240
+ const full = parts.join(sep);
241
+
242
+ let slug = full;
243
+ if (maxLength && full.length > maxLength) {
244
+ // 語の途中では切らない。1語目だけで上限を超えるときに限り、語の中で切る
245
+ slug = '';
246
+ for (const p of parts) {
247
+ const next = slug ? slug + sep + p : p;
248
+ if (next.length > maxLength) break;
249
+ slug = next;
250
+ }
251
+ if (!slug) slug = parts[0].slice(0, maxLength);
252
+ }
253
+
254
+ const notes = [];
255
+ if (!src.trim()) notes.push({ code: 'EMPTY' });
256
+ else if (!slug) notes.push({ code: 'NO_SLUG' });
257
+ if (t.kanji.length) notes.push({ code: 'KANJI', items: t.kanji.slice(0, 12), count: t.kanji.length });
258
+ if (t.other.length) notes.push({ code: 'OTHER', items: t.other.slice(0, 12), count: t.other.length });
259
+ if (slug !== full) notes.push({ code: 'TRUNCATED', from: full.length, to: slug.length });
260
+ if (/^[0-9]+$/.test(slug)) notes.push({ code: 'NUMERIC' });
261
+ if (slug.length > 60 && slug === full) notes.push({ code: 'LONG', length: slug.length });
262
+
263
+ return {
264
+ slug,
265
+ source: useReading ? 'reading' : 'title',
266
+ separator,
267
+ longVowel,
268
+ romaji: parts.join(' '),
269
+ words,
270
+ length: slug.length,
271
+ kanji: t.kanji,
272
+ other: t.other,
273
+ notes,
274
+ };
275
+ }
276
+
277
+ /* ==================== ここまでスラッグ生成コア ==================== */
278
+
279
+ // 指摘事項のコード → 文。site側は同じコードを日英それぞれの文へ訳している
280
+ const NOTE_TEXT = {
281
+ ja: {
282
+ EMPTY: () => 'タイトルも読みも空です。',
283
+ NO_SLUG: () => 'ローマ字にできる文字がありません。reading にかなで読みを渡してください。',
284
+ KANJI: (n) => `漢字はスラッグに入れていません(${n.items.join(' ')})。reading にかなで読みを渡してください。`,
285
+ OTHER: (n) => `かな・英数字以外の文字は省いています(${n.items.join(' ')})。`,
286
+ TRUNCATED: (n) => `${n.from}文字を語の切れ目で${n.to}文字に縮めました。`,
287
+ NUMERIC: () => '数字だけのスラッグは、パーマリンク設定によっては日付アーカイブ(/2026/ など)と衝突するため、WordPress が末尾に -2 を付けて保存することがあります。',
288
+ LONG: (n) => `${n.length}文字はURLとしては長めです。助詞(no・wo・ni など)や飾りの語を reading から外すと短くなります。`,
289
+ DUPLICATE: (n) => `同じスラッグになる項目があります: ${n.items.join(' / ')}(WordPress では2件目以降に -2 などが付きます)。`,
290
+ },
291
+ en: {
292
+ EMPTY: () => 'Both the title and the reading are empty.',
293
+ NO_SLUG: () => 'Nothing can be turned into letters. Pass the reading in kana as reading.',
294
+ KANJI: (n) => `Kanji are left out of the slug (${n.items.join(' ')}). Pass the reading in kana as reading.`,
295
+ OTHER: (n) => `Characters other than kana and Latin letters are left out (${n.items.join(' ')}).`,
296
+ TRUNCATED: (n) => `Shortened from ${n.from} to ${n.to} characters at a word boundary.`,
297
+ NUMERIC: () => 'A slug made only of digits can clash with date archives (/2026/) depending on the permalink settings, and WordPress may save it with -2 appended.',
298
+ LONG: (n) => `${n.length} characters is long for a URL. Dropping particles (no, wo, ni…) and filler words from reading shortens it.`,
299
+ DUPLICATE: (n) => `Some items produce the same slug: ${n.items.join(' / ')} (WordPress appends -2 and so on to the later ones).`,
300
+ },
301
+ };
302
+
303
+ const MAX_ITEMS = 1000;
304
+
305
+ export class SlugToolError extends Error {}
306
+
307
+ function noteMessages(notes, lang) {
308
+ return notes.map((n) => {
309
+ const out = { code: n.code, message: NOTE_TEXT[lang][n.code] ? NOTE_TEXT[lang][n.code](n) : n.code };
310
+ if (n.items) out.items = n.items;
311
+ return out;
312
+ });
313
+ }
314
+
315
+ // 1件ぶんの結果。区切り × 長音の4通りも添える(site の「ほかの書き方」と同じ)
316
+ function one(item, o, lang) {
317
+ const r = slugGenerate({ ...o, title: item.title, reading: item.reading });
318
+ const variants = {};
319
+ for (const separator of Object.keys(SLUG_SEPARATORS)) {
320
+ for (const longVowel of SLUG_LONG_VOWELS) {
321
+ variants[`${separator}_${longVowel}`] = slugGenerate({ ...o, title: item.title, reading: item.reading, separator, longVowel }).slug;
322
+ }
323
+ }
324
+ return {
325
+ title: item.title,
326
+ ...(item.reading ? { reading: item.reading } : {}),
327
+ slug: r.slug,
328
+ length: r.length,
329
+ source: r.source,
330
+ romaji: r.romaji,
331
+ words: r.words.map((w) => ({ input: w.input, output: w.output })),
332
+ skipped: { kanji: r.kanji, other: r.other },
333
+ variants,
334
+ notes: noteMessages(r.notes, lang),
335
+ };
336
+ }
337
+
338
+ /**
339
+ * 日本語タイトル(または読み)から URL スラッグを作る。
340
+ *
341
+ * @param {object} opts
342
+ * @param {string} [opts.title] タイトル(items と排他)
343
+ * @param {string} [opts.reading] 読み。空でなければタイトルの代わりにこちらから作る
344
+ * @param {{title?:string, reading?:string}[]} [opts.items] まとめて作る(1000件まで)
345
+ * @param {'kebab'|'snake'} [opts.separator='kebab']
346
+ * @param {'omit'|'keep'} [opts.longVowel='omit']
347
+ * @param {boolean} [opts.splitKatakana=true]
348
+ * @param {number} [opts.maxLength=0] 0=無制限
349
+ * @param {'ja'|'en'} [opts.lang='ja']
350
+ */
351
+ export async function slugGenerateTool(opts = {}) {
352
+ const lang = opts.lang || 'ja';
353
+ if (lang !== 'ja' && lang !== 'en') throw new SlugToolError(`lang は ja か en: ${opts.lang}`);
354
+ const separator = opts.separator === undefined ? 'kebab' : opts.separator;
355
+ if (!SLUG_SEPARATORS[separator]) throw new SlugToolError(`separator は kebab か snake: ${opts.separator}`);
356
+ const longVowel = opts.longVowel === undefined ? 'omit' : opts.longVowel;
357
+ if (SLUG_LONG_VOWELS.indexOf(longVowel) === -1) throw new SlugToolError(`longVowel は omit か keep: ${opts.longVowel}`);
358
+ const maxLength = opts.maxLength === undefined ? 0 : opts.maxLength;
359
+ if (!Number.isInteger(maxLength) || maxLength < 0 || maxLength > 200) {
360
+ throw new SlugToolError(`maxLength は 0〜200 の整数(0=無制限): ${opts.maxLength}`);
361
+ }
362
+ const o = { separator, longVowel, maxLength, splitKatakana: opts.splitKatakana !== false };
363
+
364
+ if (opts.items !== undefined) {
365
+ if (opts.title !== undefined || opts.reading !== undefined) throw new SlugToolError('items と title/reading は同時に渡せません');
366
+ if (!Array.isArray(opts.items) || !opts.items.length) throw new SlugToolError('items は1件以上の配列で渡してください');
367
+ if (opts.items.length > MAX_ITEMS) throw new SlugToolError(`items は ${MAX_ITEMS} 件まで: ${opts.items.length}`);
368
+ const results = opts.items.map((it) => {
369
+ const item = typeof it === 'string' ? { title: it } : it || {};
370
+ return one({ title: String(item.title ?? ''), reading: String(item.reading ?? '') }, o, lang);
371
+ });
372
+ // 同じスラッグの衝突(WordPress は後の記事に -2 を付ける)
373
+ const seen = new Map();
374
+ for (const r of results) if (r.slug) seen.set(r.slug, (seen.get(r.slug) || 0) + 1);
375
+ const dupes = [...seen].filter(([, n]) => n > 1).map(([s]) => s);
376
+ const notes = dupes.length ? noteMessages([{ code: 'DUPLICATE', items: dupes.slice(0, 20) }], lang) : [];
377
+ return { count: results.length, separator, longVowel, max_length: maxLength, results, notes };
378
+ }
379
+
380
+ if (typeof opts.title !== 'string' && typeof opts.reading !== 'string') {
381
+ throw new SlugToolError('title か reading(またはまとめて作るなら items)を渡してください');
382
+ }
383
+ return { separator, longVowel, max_length: maxLength, ...one({ title: opts.title || '', reading: opts.reading || '' }, o, lang) };
384
+ }