@first-ch/tools-mcp 0.42.1 → 0.43.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 (3) hide show
  1. package/README.md +4 -2
  2. package/apps.mjs +14 -0
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
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. All of those run on your machine.
4
4
 
5
- It also ships **`app_*` tools** for the 36 web apps at [apps.first-ch.com](https://apps.first-ch.com) (site checks such as GEO/AI-search readiness, meta tags, security headers, SSL certificates, DNS and email DNS, redirects, broken links, structured data, AI-crawler access, Japanese readability, and AI-assisted business-tone and LP-copy checks). Unlike the local tools, **an `app_*` tool sends its input (a URL, domain name or text) to apps.first-ch.com** and returns the JSON the app's API responds with — see [Network access, files and privacy](#network-access-files-and-privacy).
5
+ It also ships **`app_*` tools** for the 37 web apps at [apps.first-ch.com](https://apps.first-ch.com) (site checks such as GEO/AI-search readiness, meta tags, security headers, SSL certificates, DNS and email DNS, redirects, broken links, structured data, AI-crawler access, Japanese readability, and AI-assisted business-tone and LP-copy checks). Unlike the local tools, **an `app_*` tool sends its input (a URL, domain name or text) to apps.first-ch.com** and returns the JSON the app's API responds with — see [Network access, files and privacy](#network-access-files-and-privacy).
6
6
 
7
7
  日本語版は [後半セクション](#日本語) を参照してください。
8
8
 
@@ -117,6 +117,7 @@ Each `app_*` tool calls one app's public JSON API (`POST https://apps.first-ch.c
117
117
  | `app_mixed_content` | [Mixed Content Checker](https://apps.first-ch.com/en/mixed-content/) — Enter a URL to list every http:// reference left inside an https page (img, script, link, iframe, video, source and CSS url()), with its line number, the offending tag and how to fix it. References browsers block are separated from the ones they auto-upgrade. | `url` |
118
118
  | `app_image_audit` | [Page Image Audit](https://apps.first-ch.com/en/image-audit/) — Enter a URL to audit every img / picture on the page: format (WebP / AVIF adoption), loading=lazy, width/height attributes and alt text. For the first 30 images the real file size and served format are measured with a HEAD request. | `url` |
119
119
  | `app_gazou_ichijouhou` | [Photo Location Leak Check](https://apps.first-ch.com/en/gazou-ichijouhou/) — Pairs each JPEG on a page with its WordPress original (the URL without the -WIDTHxHEIGHT / -scaled suffix on the same server) and checks whether the Exif still holds the shooting location (GPS latitude and longitude). Each call judges five pairs from `offset` and returns the list of pairs (first 20), a state and reason per image and the next `offset`; call again until `next` is null. Coordinates, capture dates and image bytes are never returned, and "none" is not a guarantee. | `url`, `offset?` |
120
+ | `app_hp_sumaho_check` | [Look at Our Site on Your Phone — 3-Question Check Card](https://apps.first-ch.com/en/hp-sumaho-check/) — Reads the page's HTML and up to 3 same-site stylesheets (96KB / 2,000 rules parsed in total) for three mobile points: a tel: link for every phone number in the text, sideways scrolling (viewport width=device-width, fixed width / min-width of 900px+ on body, #wrapper and similar) and text & zoom (user-scalable=no, maximum-scale=1, body / p below 12px). Each point is `check` / `none` / `unknown` (with reasons), with locations (HTML line, CSS file and line) and fix hints, plus up to 3 yes/no questions to ask someone checking on a real phone and a share URL with `ref`. No pass/fail or score, not a judgement of real rendering; the page and CSS are never returned. | `url` |
120
121
  | `app_tech_detect` | [Tech Stack Detector](https://apps.first-ch.com/en/tech-detect/) — Enter a URL to infer the CMS (WordPress, Shopify, Wix, STUDIO and more), framework, CDN, analytics tags (GA4/GTM) and web fonts from HTML and header signatures — always with the evidence behind each guess. | `url` |
121
122
  | `app_gaibu_soushinsaki` | [Third-Party Tag Inventory](https://apps.first-ch.com/en/gaibu-soushinsaki/) — Fetches one page and matches the script src, img and iframe hosts and inline install snippets in its HTML against a table of 18 major analytics, advertising and social-embed services (Google, Meta, Microsoft, LinkedIn, LY Corporation, X). Returns the company count, per-service details (typical purpose, where to stop it, official source), discontinued services such as Universal Analytics, external hosts not in the table, and a CSV checklist. It only reads what is written in the HTML: it does not verify actual data transmission or legal compliance, and tags inside a tag manager are invisible. | `url` |
122
123
  | `app_wp_check` | [WordPress Quick Audit](https://apps.first-ch.com/en/wp-check/) — Enter a URL to see whether the site runs WordPress, which theme it uses, the version it announces, and whether REST API username enumeration, xmlrpc.php, author archives, the default login URL, readme.html or a debug log are exposed. Read-only GETs, never enumeration. | `url` |
@@ -190,7 +191,7 @@ Release rule: a push to `main` automatically publishes a new package version thr
190
191
 
191
192
  `@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ツールとして提供するサーバーです。これらは全て端末内で処理します。
192
193
 
193
- あわせて、[apps.first-ch.com](https://apps.first-ch.com) のWebアプリ36本(GEO・メタタグ・セキュリティヘッダー・SSL証明書・DNS/メールDNS・リダイレクト・リンク切れ・構造化データ・AIクローラー許可・和文可読性・AIによるビジネス文面/LP文言のチェックなど)を呼ぶ **`app_*` ツール**も提供します。**`app_*` ツールは入力(URL・ドメイン名・文面)を apps.first-ch.com のサーバーへ送り**、アプリの API が返した JSON を返します(端末内で完結する他のツールとはここが違います)。詳しくは [通信・ファイル・プライバシー](#通信ファイルプライバシー) を参照してください。
194
+ あわせて、[apps.first-ch.com](https://apps.first-ch.com) のWebアプリ37本(GEO・メタタグ・セキュリティヘッダー・SSL証明書・DNS/メールDNS・リダイレクト・リンク切れ・構造化データ・AIクローラー許可・和文可読性・AIによるビジネス文面/LP文言のチェックなど)を呼ぶ **`app_*` ツール**も提供します。**`app_*` ツールは入力(URL・ドメイン名・文面)を apps.first-ch.com のサーバーへ送り**、アプリの API が返した JSON を返します(端末内で完結する他のツールとはここが違います)。詳しくは [通信・ファイル・プライバシー](#通信ファイルプライバシー) を参照してください。
194
195
 
195
196
  ### インストール
196
197
 
@@ -303,6 +304,7 @@ claude mcp add firstch-tools -- npx -y @first-ch/tools-mcp
303
304
  | `app_mixed_content` | [混在コンテンツチェッカー](https://apps.first-ch.com/mixed-content/) — https のページに残った http:// の参照(img・script・link・iframe・video・source・CSS の url())を抽出し、行番号・タグ・直し方と、ブラウザがブロックするか自動で https 化されるかを返す。見つかった http:// のURLへはアクセスしない。 | `url` |
304
305
  | `app_image_audit` | [ページ内画像診断](https://apps.first-ch.com/image-audit/) — URLのページ内の img / picture を抽出し、フォーマット(WebP・AVIF 対応)・loading=lazy・width/height の指定・alt を診断する。先頭30枚は HEAD リクエストで実際のファイルサイズと形式まで測る。 | `url` |
305
306
  | `app_gazou_ichijouhou` | [写真の位置情報チェック](https://apps.first-ch.com/gazou-ichijouhou/) — URLのページの JPEG と、WordPress の元画像の候補(-幅x高さ・-scaled を外した同じサーバーのURL)を組にして、Exif に撮影場所(GPS の緯度・経度)が残っていないかを調べる。1回で offset から5組を判定し、組の一覧(先頭20組)・画像ごとの状態と理由・次の offset を返す(next が null になるまで呼ぶ)。座標・撮影日時の値と画像のバイト列は返さない。「none」は安全の保証ではない。 | `url`, `offset?` |
307
+ | `app_hp_sumaho_check` | [うちのHP、スマホで見て3つ教えて|確認依頼カード](https://apps.first-ch.com/hp-sumaho-check/) — ページの HTML と同じサイトの CSS(最大3本・解析は合計96KB/2,000規則まで)から、①本文の電話番号ごとの tel: リンク ②横ずれ(viewport の width=device-width・body や #wrapper 等の900px以上の固定幅) ③文字と拡大(user-scalable=no・maximum-scale=1・body/p の12px未満)を check/none/unknown(理由つき)で返し、記述の位置・直し方の要点と、実機で見てもらう人に聞く「はい/いいえ」の質問(最大3問)・ref 付きの共有URLを返す。合否・点数は出さず、実機の表示の判定ではない。原文は返さない。 | `url` |
306
308
  | `app_tech_detect` | [技術スタック検出](https://apps.first-ch.com/tech-detect/) — URLのページの HTML と応答ヘッダーのシグネチャから、CMS(WordPress・Shopify・Wix・STUDIO 等)・フレームワーク・CDN・解析タグ(GA4/GTM)・Webフォントを推定し、そう判断した根拠(どこで何に合致したか)と一緒に返す。 | `url` |
307
309
  | `app_gaibu_soushinsaki` | [外部タグ棚卸し(解析・広告・SNS埋め込み)](https://apps.first-ch.com/gaibu-soushinsaki/) — URLのページを1回だけ取得し、HTMLに書かれた script の src・img・iframe の外部ホストとインラインの設置スニペットを、主要18サービス(Google・Meta・Microsoft・LinkedIn・LINEヤフー・X)の対応表と照合する。会社数・サービスごとの明細(一般的な用途・止める場所・公式資料の出典)・終了済みサービス(UA など)・表にない外部ホストと、確認用の棚卸し表(CSV)を返す。HTMLに書かれたタグだけを見るもので、実際の送信や法令への適合は判定しない(タグマネージャー経由のタグは見えない)。 | `url` |
308
310
  | `app_wp_check` | [WordPress簡易診断](https://apps.first-ch.com/wp-check/) — URLのサイトが WordPress かどうか・テーマ名・名乗っている範囲のバージョンを判定し、REST API のユーザー名列挙・xmlrpc.php・著者アーカイブ・既定のログインURL・readme.html・デバッグログの露出を診断する。攻撃的な列挙はせず GET で見える範囲だけを見る(WordPress の痕跡があるときだけ既定パス7本を追加で GET。ユーザー名は件数だけ返す)。 | `url` |
package/apps.mjs CHANGED
@@ -218,6 +218,20 @@ const DEFS = [
218
218
  lang: LANG,
219
219
  },
220
220
  },
221
+ {
222
+ slug: 'hp-sumaho-check',
223
+ apiPath: '/hp-sumaho-check/api/check',
224
+ title: 'うちのHP、スマホで見て3つ教えて|確認依頼カード(電話リンク・横ずれ・文字と拡大)',
225
+ summary:
226
+ 'URLのページの HTML と同じサイトの CSS(最大3本・解析は合計96KB/2,000規則まで)から、スマホで人に見てもらうべき3項目を判定する。' +
227
+ '①電話: 本文の電話番号ごとに tel: リンクがあるか(format-detection telephone=no も併記) ②横ずれ: viewport の width=device-width と、body・#wrapper 等の900px以上の固定 width/min-width ' +
228
+ '③文字と拡大: user-scalable=no・maximum-scale=1・body/p の12px未満。各項目を check(要確認)/none(記述なし)/unknown(判定できない・理由つき)で返し、記述の位置(HTMLの行・CSSのファイルと行)・直し方の要点と、' +
229
+ 'はい/いいえで答える質問(要確認を優先して最大3問)・ref 付きの共有URLを返す。合否・点数は出さず、実機の表示を判定したものではない。ページと CSS の原文は返さない。同じIPから10分に20回まで(超えると HTTP 429)。',
230
+ sends: '入力したURL',
231
+ fetches: true,
232
+ slow: false,
233
+ inputSchema: { url: URL_PARAM('確かめるホームページのURL'), lang: LANG },
234
+ },
221
235
  urlApp(
222
236
  'tech-detect',
223
237
  '/tech-detect/api/detect',
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@first-ch/tools-mcp",
3
- "version": "0.42.1",
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スラッグ生成(かな→ヘボン式ローマ字・記号除去・ハイフン/アンダースコア連結・小文字化・長音の省略/表記)・Basic認証用 htpasswd の生成と照合(bcrypt / apr1-md5・パスワードの自動生成・Apache / nginx の設定スニペット)・OpenAPI/Swagger仕様書から日本語のMarkdownドキュメントとTypeScript型定義の生成(OpenAPI 3.x / Swagger 2.0・YAML/JSON・$ref/allOf/oneOf 対応・エンドポイントごとの引数/レスポンス型・外部 $ref は読みに行かない)・FAQ構造化データ(FAQPage の JSON-LD・Markdown・details/summary の HTML を同時生成・回答のリンク/箇条書きを HTML 化・「Q: / A:」形式の一括貼り付けの解析)・テキストの行操作(重複行の削除・数値を認識する並べ替え・シード付きシャッフル・行番号・空行除去・前後トリム・接頭辞/接尾辞)・印刷サイズとDPIの計算(用紙×解像度×塗り足しから必要なピクセル数・手持ちの画像の実効dpiと判定・早見表・mm/inch/px/pt/級の換算)・SERPのメタタグ文字数チェック(title / description が検索結果に収まるかをピクセル幅で判定・切り詰め位置と表示行・パンくず表示・https や階層の指摘)・Flexbox / CSS GridのCSS生成(既定値を省いた宣言・repeat()への畳み込み・grid-template-areasの検証・効かない組み合わせの指摘・定番プリセット)・社内文書の点検(Notion・Confluence などから書き出した Markdown/HTML の重複ページ・孤立ページ・表記ゆれや旧称・リンク切れの検出と修正案)・記入欄に収める字の大きさと改行位置(中袋〔ご祝儀袋・香典袋〕の住所欄などの幅・高さmmから1字の大きさ・行数・改行位置・縦書きの漢数字・金額の大字))をMCPツールとして提供するサーバー。あわせて apps.first-ch.com のWebアプリ36本(GEO・メタタグ・セキュリティヘッダー・SSL・DNS・リダイレクト・リンク切れ・構造化データ・AIクローラー許可・和文可読性・ビジネス文面チェック等)の JSON API を呼ぶ app_* ツールも提供する(こちらは入力を apps.first-ch.com へ送るため既定では無効・FIRSTCH_ENABLE_APPS=1 で有効)",
3
+ "version": "0.43.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スラッグ生成(かな→ヘボン式ローマ字・記号除去・ハイフン/アンダースコア連結・小文字化・長音の省略/表記)・Basic認証用 htpasswd の生成と照合(bcrypt / apr1-md5・パスワードの自動生成・Apache / nginx の設定スニペット)・OpenAPI/Swagger仕様書から日本語のMarkdownドキュメントとTypeScript型定義の生成(OpenAPI 3.x / Swagger 2.0・YAML/JSON・$ref/allOf/oneOf 対応・エンドポイントごとの引数/レスポンス型・外部 $ref は読みに行かない)・FAQ構造化データ(FAQPage の JSON-LD・Markdown・details/summary の HTML を同時生成・回答のリンク/箇条書きを HTML 化・「Q: / A:」形式の一括貼り付けの解析)・テキストの行操作(重複行の削除・数値を認識する並べ替え・シード付きシャッフル・行番号・空行除去・前後トリム・接頭辞/接尾辞)・印刷サイズとDPIの計算(用紙×解像度×塗り足しから必要なピクセル数・手持ちの画像の実効dpiと判定・早見表・mm/inch/px/pt/級の換算)・SERPのメタタグ文字数チェック(title / description が検索結果に収まるかをピクセル幅で判定・切り詰め位置と表示行・パンくず表示・https や階層の指摘)・Flexbox / CSS GridのCSS生成(既定値を省いた宣言・repeat()への畳み込み・grid-template-areasの検証・効かない組み合わせの指摘・定番プリセット)・社内文書の点検(Notion・Confluence などから書き出した Markdown/HTML の重複ページ・孤立ページ・表記ゆれや旧称・リンク切れの検出と修正案)・記入欄に収める字の大きさと改行位置(中袋〔ご祝儀袋・香典袋〕の住所欄などの幅・高さmmから1字の大きさ・行数・改行位置・縦書きの漢数字・金額の大字))をMCPツールとして提供するサーバー。あわせて apps.first-ch.com のWebアプリ37本(GEO・メタタグ・セキュリティヘッダー・SSL・DNS・リダイレクト・リンク切れ・構造化データ・AIクローラー許可・和文可読性・ビジネス文面チェック等)の JSON API を呼ぶ app_* ツールも提供する(こちらは入力を apps.first-ch.com へ送るため既定では無効・FIRSTCH_ENABLE_APPS=1 で有効)",
5
5
  "type": "module",
6
6
  "bin": {
7
7
  "firstch-tools-mcp": "server.mjs"