@first-ch/tools-mcp 0.36.0 → 0.37.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.
package/apps.mjs ADDED
@@ -0,0 +1,538 @@
1
+ // apps.first-ch.com(First CH の「サーバーで動くWebアプリ」)の JSON API を呼ぶツールの定義表。
2
+ //
3
+ // 他のツール(端末内で計算する)と違い、ここのツールは入力(URL・ドメイン名・文面など)を
4
+ // apps.first-ch.com のサーバーへ送り、そこで処理した結果を受け取る薄い HTTP クライアント。
5
+ // 全アプリが認証なしの `POST https://apps.first-ch.com/<slug>/api/<action>` を持つ
6
+ // (一覧は https://apps.first-ch.com/llms.txt・正本は FirstCHApps の functions/_shared/apps-registry.ts)。
7
+ // 入力の形は各アプリの functions/<slug>/[[path]].ts の API 実装に合わせている。
8
+ //
9
+ // server.mjs は APP_TOOLS をループで登録するだけにして、apps 側の変更はこのファイルに閉じる。
10
+ import { z } from 'zod';
11
+
12
+ export const DEFAULT_APPS_BASE_URL = 'https://apps.first-ch.com';
13
+ /** テスト・検証環境向けにベース URL を差し替える環境変数 */
14
+ export const APPS_BASE_URL_ENV = 'FIRSTCH_APPS_BASE_URL';
15
+ /** 1回の呼び出しの待ち時間の既定(ミリ秒) */
16
+ export const DEFAULT_TIMEOUT_MS = 30_000;
17
+ /** 取得件数が多い・AI を呼ぶアプリの待ち時間(AI 側のタイムアウトが45秒のため、それより長くする) */
18
+ export const SLOW_TIMEOUT_MS = 60_000;
19
+ /** 応答本文の上限(API の JSON は数十KB程度。想定外に大きい応答で固まらないための保険) */
20
+ const MAX_RESPONSE_CHARS = 5_000_000;
21
+
22
+ // ---------------------------------------------------------------------------
23
+ // 説明文の共通部品
24
+ // ---------------------------------------------------------------------------
25
+
26
+ const SENDS = (what) =>
27
+ `**この呼び出しは${what}を First CH のサーバー apps.first-ch.com へ送って処理する**(他の First CH ツールと違い、端末内では完結しない)。` +
28
+ '入力も結果もサーバーには保存されない。';
29
+ const FETCHES = 'apps.first-ch.com のサーバーが対象のサイトへアクセスするので、相手のサーバーにはこちらの端末ではなく apps.first-ch.com からのアクセスとして記録される。';
30
+ const RESULT = '応答は API の JSON をそのまま返す(入力の不備・相手サイトに届かない等は error と message つきのエラーになる)。';
31
+ const AI_LIMIT =
32
+ '**回数制限あり**: 同じIPから10分に5回まで、さらに app_tone_check と app_lp_persona_check の合計で1日50回まで(日本時間9時にリセット)。' +
33
+ '超えると HTTP 429(rate_limited / daily_limit)が返るので、間を置くか翌日に回す。AI による参考意見で、結果は毎回少し変わりうる。';
34
+
35
+ const LANG = z
36
+ .enum(['ja', 'en'])
37
+ .optional()
38
+ .describe("結果の文言(判定・指摘・エラー文)の言語。既定 'ja'。'en' は英語版の API(/en/…)を呼ぶ");
39
+
40
+ const URL_PARAM = (what = '診断するページのURL') =>
41
+ z.string().min(1).max(2048).describe(`${what}(http/https。スキームを省くと https:// を補う)`);
42
+ const DOMAIN_PARAM = z.string().min(1).max(512).describe('ドメイン名(例: example.com。URLを渡してもホスト名だけを使う)');
43
+
44
+ /** URL を1つ受けるアプリ(大半)の定義を作る */
45
+ function urlApp(slug, apiPath, title, summary, extra = {}) {
46
+ return {
47
+ slug,
48
+ apiPath,
49
+ title,
50
+ summary,
51
+ sends: extra.sends ?? '入力したURL',
52
+ fetches: true,
53
+ slow: extra.slow ?? false,
54
+ inputSchema: { url: URL_PARAM(extra.urlLabel), lang: LANG },
55
+ };
56
+ }
57
+
58
+ // ---------------------------------------------------------------------------
59
+ // 定義表(apps-registry.ts の APPS と同じ並び)
60
+ // ---------------------------------------------------------------------------
61
+
62
+ const DEFS = [
63
+ urlApp(
64
+ 'geo',
65
+ '/geo/api/diagnose',
66
+ 'GEO簡易チェッカー(AI検索に引用されやすいか)',
67
+ 'URLのページが AI検索(ChatGPT・Perplexity・Gemini・AI Overviews)に引用されやすい構造かを6軸100点で診断し、軸ごとの点数・グレード・見つかった JSON-LD の型・AIクローラーの拒否状況・改善点を返す。',
68
+ ),
69
+ urlApp(
70
+ 'meta-check',
71
+ '/meta-check/api/inspect',
72
+ 'メタタグ・SEO基本診断',
73
+ 'URLのページの title・meta description・canonical・robots・h1・OGP・lang・viewport を取得して合否つきで返す。文字数(title 全角32字・description 100〜170字)と robots.txt のクロール可否も判定する。',
74
+ ),
75
+ urlApp(
76
+ 'headers',
77
+ '/headers/api/inspect',
78
+ 'セキュリティヘッダー採点',
79
+ 'URLの応答の CSP・HSTS・X-Content-Type-Options・X-Frame-Options・Referrer-Policy・Permissions-Policy を100点満点で採点し、A〜Fの評価・各ヘッダーの値・解説と推奨設定例を返す。',
80
+ ),
81
+ {
82
+ slug: 'ssl',
83
+ apiPath: '/ssl/api/inspect',
84
+ title: 'SSL/TLS証明書チェッカー',
85
+ summary:
86
+ 'ホスト名へサーバー側から実際に TLS 接続し、配信中の証明書の有効期限・残り日数・発行者・SAN・中間証明書のチェーンを返す(期限30日切れで警告)。接続できないときは CT ログの記録から読む。',
87
+ sends: '入力したホスト名(TLS の SNI としても送る)',
88
+ fetches: true,
89
+ inputSchema: {
90
+ host: z.string().min(1).max(300).describe('ホスト名(例: example.com。URLを渡してもホスト名だけを使う。ポートは 443 のみ)'),
91
+ lang: LANG,
92
+ },
93
+ },
94
+ urlApp(
95
+ 'redirect-trace',
96
+ '/redirect-trace/api/trace',
97
+ 'リダイレクトチェーン追跡',
98
+ 'URLから 301・302・307・308・meta refresh の転送を1ホップずつ追跡し(最大5回)、各ステップのステータス・URL・所要時間と最終到達URLを返す。3回以上の転送には SEO 上の警告を付ける。',
99
+ ),
100
+ {
101
+ slug: 'status-check',
102
+ apiPath: '/status-check/api/check',
103
+ title: 'HTTPステータス一括チェック',
104
+ summary:
105
+ 'URLの一覧(1回10件まで)について、HTTPステータス・応答時間・リダイレクト後の最終URLをまとめて返す。リニューアル後の疎通確認やリンク集の生存確認向け。ページ本文は読まない。11件以上は10件ずつ分けて呼ぶ。',
106
+ sends: '入力したURLの一覧',
107
+ fetches: true,
108
+ slow: true,
109
+ inputSchema: {
110
+ urls: z.array(z.string().min(1).max(2048)).min(1).max(10).describe('確認するURLの配列(1〜10件)'),
111
+ lang: LANG,
112
+ },
113
+ },
114
+ {
115
+ slug: 'redirect-map',
116
+ apiPath: '/redirect-map/api/check',
117
+ title: '301リダイレクト対応表チェッカー(1組)',
118
+ summary:
119
+ 'サイト移転・リニューアルの「旧URL→新URL」1組について、旧URLの転送をたどり、期待した新URLへ厳密に一致して転送されているかを判定する。302の一時リダイレクト・チェーン・ループ・転送未設定・404も示す。' +
120
+ '対応表が複数組なら1組ずつ呼ぶ(同じIPから1分に60組まで。超えると HTTP 429)。',
121
+ sends: '旧URLと新URL',
122
+ fetches: true,
123
+ inputSchema: {
124
+ from: z.string().min(1).max(2048).describe('旧URL(転送元)'),
125
+ to: z.string().min(1).max(2048).describe('期待する新URL(転送先)'),
126
+ lang: LANG,
127
+ },
128
+ },
129
+ urlApp(
130
+ 'link-check',
131
+ '/link-check/api/inspect',
132
+ 'リンク切れ・alt属性チェック',
133
+ 'URLのページ内のリンク(a href)を抽出して最大40件の生死を確認し、404などのリンク切れ・空のリンク文字・target=_blank の危険な指定を返す。画像の alt の欠落・ファイル名のままの alt も一覧する。対象は渡した1ページだけ(サイト全体はクロールしない)。',
134
+ { slow: true },
135
+ ),
136
+ urlApp(
137
+ 'ogp-check',
138
+ '/ogp-check/api/inspect',
139
+ 'OGP確認(URL版)',
140
+ 'URLのページの og: / twitter: タグを取得して判定し、og:image を実際に取得して寸法まで確認した結果を返す。',
141
+ ),
142
+ urlApp(
143
+ 'headings',
144
+ '/headings/api/extract',
145
+ '見出し構造(h1〜h6)抽出',
146
+ 'URLのページの h1〜h6 を出現順に返し、h1 が複数・レベル飛ばし・空見出しを指摘する。構成案に貼れる Markdown のアウトラインも返す。',
147
+ ),
148
+ urlApp(
149
+ 'structured-data',
150
+ '/structured-data/api/inspect',
151
+ '構造化データ(JSON-LD)抽出・検証',
152
+ 'URLのページ内の JSON-LD を全て取り出して @type ごとに返し、JSON の構文エラーを行・列つきで検出する。Article・FAQPage・BreadcrumbList・LocalBusiness・Organization の必須/推奨プロパティの充足も判定する。',
153
+ ),
154
+ urlApp(
155
+ 'ai-access',
156
+ '/ai-access/api/check',
157
+ 'AIクローラー許可チェッカー',
158
+ 'URLのサイトの robots.txt を取得し、GPTBot・ClaudeBot・PerplexityBot・Google-Extended・CCBot・Bytespider など主要AIクローラーごとの許可/拒否と効いた Disallow を返す。llms.txt の有無と X-Robots-Tag も確認する。',
159
+ ),
160
+ {
161
+ slug: 'robots-tester',
162
+ apiPath: '/robots-tester/api/test',
163
+ title: 'robots.txt テスター',
164
+ summary:
165
+ 'URLのサイトの robots.txt を取得し、指定した User-agent がそのURLをクロールしてよいかを Google のマッチング仕様(最長一致・同着は Allow 優先)で判定する。効いた規則と負けた規則を行番号つきで返し、構文の警告も出す。',
166
+ sends: '入力したURLとUser-agent名',
167
+ fetches: true,
168
+ inputSchema: {
169
+ url: URL_PARAM('判定したいURL(パスまで含める)'),
170
+ userAgent: z.string().max(300).optional().describe("User-agent 名(例: Googlebot / GPTBot。既定 'Googlebot')"),
171
+ lang: LANG,
172
+ },
173
+ },
174
+ urlApp(
175
+ 'sitemap-check',
176
+ '/sitemap-check/api/check',
177
+ 'sitemap.xml 検証',
178
+ 'サイトマップを取得して XML 構文を検証し、URL件数・lastmod の分布・サイトマップインデックスの中身(1階層)・エスケープ漏れなどの警告(行番号つき)と、抽出したURLの先頭200件を返す。サイトのURLを渡すと robots.txt から自動発見する。gzip(.xml.gz)にも対応。',
179
+ { urlLabel: 'サイトマップのURL(サイトのトップURLでも可)' },
180
+ ),
181
+ urlApp(
182
+ 'hreflang',
183
+ '/hreflang/api/check',
184
+ 'hreflang 相互参照チェック',
185
+ 'URLのページの hreflang 宣言(link rel=alternate・HTTP の Link ヘッダー)を抽出し、宣言先のページ(10件まで)も取得して返照(return link)があるかを検証する。自己参照・x-default の有無と無効な言語/地域コード(en-UK・jp 等)も判定する。',
186
+ { slow: true },
187
+ ),
188
+ urlApp(
189
+ 'mixed-content',
190
+ '/mixed-content/api/check',
191
+ '混在コンテンツチェッカー',
192
+ 'https のページに残った http:// の参照(img・script・link・iframe・video・source・CSS の url())を抽出し、行番号・タグ・直し方と、ブラウザがブロックするか自動で https 化されるかを返す。見つかった http:// のURLへはアクセスしない。',
193
+ ),
194
+ urlApp(
195
+ 'image-audit',
196
+ '/image-audit/api/inspect',
197
+ 'ページ内画像診断',
198
+ 'URLのページ内の img / picture を抽出し、フォーマット(WebP・AVIF 対応)・loading=lazy・width/height の指定・alt を診断する。先頭30枚は HEAD リクエストで実際のファイルサイズと形式まで測る。',
199
+ { slow: true },
200
+ ),
201
+ urlApp(
202
+ 'tech-detect',
203
+ '/tech-detect/api/detect',
204
+ '技術スタック検出',
205
+ 'URLのページの HTML と応答ヘッダーのシグネチャから、CMS(WordPress・Shopify・Wix・STUDIO 等)・フレームワーク・CDN・解析タグ(GA4/GTM)・Webフォントを推定し、そう判断した根拠(どこで何に合致したか)と一緒に返す。',
206
+ ),
207
+ urlApp(
208
+ 'wp-check',
209
+ '/wp-check/api/check',
210
+ 'WordPress簡易診断',
211
+ 'URLのサイトが WordPress かどうか・テーマ名・名乗っている範囲のバージョンを判定し、REST API のユーザー名列挙・xmlrpc.php・著者アーカイブ・既定のログインURL・readme.html・デバッグログの露出を診断する。攻撃的な列挙はせず GET で見える範囲だけを見る(WordPress の痕跡があるときだけ既定パス7本を追加で GET。ユーザー名は件数だけ返す)。',
212
+ ),
213
+ urlApp(
214
+ 'feed-check',
215
+ '/feed-check/api/check',
216
+ 'RSS/Atomフィード検証',
217
+ 'フィードを自動発見して取得し、XML の構文・必須要素・記事一覧・文字化け・日付形式(RSS は RFC 822・Atom は RFC 3339)を検証する。itunes 名前空間のあるフィードは Apple Podcasts の必須要素も確認する。',
218
+ { urlLabel: 'フィードのURL(サイトのURLでも可。フィードを自動発見する)' },
219
+ ),
220
+ urlApp(
221
+ 'favicon-check',
222
+ '/favicon-check/api/inspect',
223
+ 'faviconチェッカー',
224
+ 'URLのページの favicon.ico・link rel=icon・apple-touch-icon・Web App Manifest のアイコン宣言を抽出し、1件ずつ実際に取得して形式・実寸法(ICO は内包サイズ全部)・容量を返す。',
225
+ ),
226
+ {
227
+ slug: 'dns',
228
+ apiPath: '/dns/api/lookup',
229
+ title: 'DNSレコードチェッカー',
230
+ summary:
231
+ 'ドメインの A・AAAA・CNAME・MX・TXT・NS・SOA・CAA を Cloudflare の DNS over HTTPS(1.1.1.1)で引いて返す。www の向き先・SPF が1本か・CAA の有無も判定する。',
232
+ sends: '入力したドメイン名',
233
+ fetches: false,
234
+ inputSchema: { domain: DOMAIN_PARAM, lang: LANG },
235
+ },
236
+ {
237
+ slug: 'dns-propagation',
238
+ apiPath: '/dns-propagation/api/check',
239
+ title: 'DNS伝播チェック',
240
+ summary:
241
+ 'ドメインとレコード種別を5つの公開DNSリゾルバ(Cloudflare・Google・OpenDNS ほか)へ同時に問い合わせ、回答が一致しているかを返す。TTL と SOA serial から「反映待ち」と「設定ミス」を切り分けられる。expected を渡すと期待する値と一致したかも判定する。',
242
+ sends: '入力したドメイン名とレコード種別(と期待する値)',
243
+ fetches: false,
244
+ inputSchema: {
245
+ domain: DOMAIN_PARAM,
246
+ type: z.enum(['A', 'AAAA', 'CNAME', 'MX', 'TXT', 'NS', 'CAA']).optional().describe("レコード種別(既定 'A')"),
247
+ expected: z.string().max(256).optional().describe('期待する値(例: 192.0.2.10。渡すと各リゾルバの回答と照合する)'),
248
+ lang: LANG,
249
+ },
250
+ },
251
+ {
252
+ slug: 'email-dns',
253
+ apiPath: '/email-dns/api/check',
254
+ title: 'メール設定チェッカー(MX・SPF・DKIM・DMARC)',
255
+ summary:
256
+ 'ドメインの MX・SPF・DKIM・DMARC を引いて診断する。SPF は include: をたどって DNS ルックアップ10回の上限を実測し、DMARC のポリシーを解釈して Gmail 送信者ガイドライン(2024年〜)への適合も判定する。DKIM はセレクタが分からないと確認できないため、省略時は代表的なセレクタを当てる(見つからなくても DKIM が無いとは限らない)。',
257
+ sends: '入力したドメイン名と DKIM セレクタ',
258
+ fetches: false,
259
+ inputSchema: {
260
+ domain: DOMAIN_PARAM,
261
+ selector: z
262
+ .string()
263
+ .max(200)
264
+ .optional()
265
+ .describe('DKIM セレクタ(例: google / selector1。カンマ区切りで3個まで。省略時は代表的なものを当てる)'),
266
+ lang: LANG,
267
+ },
268
+ },
269
+ {
270
+ slug: 'domain-info',
271
+ apiPath: '/domain-info/api/lookup',
272
+ title: 'ドメイン情報・期限チェッカー(RDAP)',
273
+ summary:
274
+ 'ドメインを RDAP(WHOIS の後継)で引き、レジストラ・作成日・有効期限と残り日数・ステータス(clientHold 等)・ネームサーバーを返す。RDAP 非対応の TLD(.jp を含む)はその旨を返す。登録者・管理者の個人情報は読まない。',
275
+ sends: '入力したドメイン名',
276
+ fetches: false,
277
+ inputSchema: { domain: DOMAIN_PARAM, lang: LANG },
278
+ },
279
+ {
280
+ slug: 'domain-availability',
281
+ apiPath: '/domain-availability/api/check',
282
+ title: 'ドメイン空き一括チェック',
283
+ summary:
284
+ 'サービス名・屋号の候補1つについて、.com / .net / .org / .jp / .co.jp / .dev / .io / .ai / .app / .co の登録有無を RDAP と公開DNSでまとめて判定する。判定は「登録済み/未登録の可能性/判定不能」の3値で、空きは断定しない。',
285
+ sends: '入力した名前',
286
+ fetches: false,
287
+ slow: true,
288
+ inputSchema: {
289
+ name: z.string().min(1).max(253).describe('調べる名前(例: firstch。firstch.com のように TLD つきで渡してもよい)'),
290
+ lang: LANG,
291
+ },
292
+ },
293
+ {
294
+ slug: 'myip',
295
+ apiPath: '/myip/api/info',
296
+ title: 'IP・リクエスト情報の確認',
297
+ summary:
298
+ 'この MCP サーバーが動いている端末から apps.first-ch.com へ届いたリクエストを見て、グローバルIP・推定国/都市・回線(ASN)・HTTP/TLS の方式・User-Agent・主要リクエストヘッダーを返す。VPN の切り替え確認などに使う。',
299
+ sends: 'リクエストそのもの(端末のグローバルIPとヘッダー)',
300
+ fetches: false,
301
+ inputSchema: { lang: LANG },
302
+ },
303
+ urlApp(
304
+ 'brand-fetch',
305
+ '/brand-fetch/api/extract',
306
+ 'ブランド情報抽出',
307
+ 'サイトのロゴ・ファビコン・主要配色・会社説明を抽出して返す。配色は CSS の出現頻度順で、白地・黒地とのコントラスト比つき。画像は URL と寸法だけを返す。提案書やモックの仮ブランド作りに使う。',
308
+ { urlLabel: 'サイトのURLまたはドメイン(例: example.com)' },
309
+ ),
310
+ {
311
+ slug: 'tone-check',
312
+ apiPath: '/tone-check/api/check',
313
+ title: 'ビジネス文面のニュアンスチェック(AI)',
314
+ summary:
315
+ '日本語のビジネスメール・提案文の失礼・曖昧・二重敬語・催促のきつさを「相手にどう受け取られるか」の観点で指摘し、言い換え候補を返す。英訳して送るときの文化的な誤解ポイントも添える。',
316
+ sends: '入力した文面',
317
+ ai: true,
318
+ slow: true,
319
+ inputSchema: {
320
+ text: z.string().min(1).max(2000).describe('確認する日本語の文面(2000文字まで)'),
321
+ lang: LANG,
322
+ },
323
+ },
324
+ {
325
+ slug: 'lp-persona-check',
326
+ apiPath: '/lp-persona-check/api/check',
327
+ title: 'LP文言・ペルソナ反応チェッカー(AI)',
328
+ summary:
329
+ 'LP・サービス紹介の訴求文を、選んだ業種(士業・EC・BtoB SaaS)の疑似ペルソナ3人の視点で読み、分かりやすさ・信頼性・購買意欲への影響の推定スコア、敬語トーンの強弱(5段階)、ペルソナごとの反応、言い換え案を返す。疑似ペルソナによる推測で、実在の顧客の反応ではない。',
330
+ sends: '入力した訴求文と業種',
331
+ ai: true,
332
+ slow: true,
333
+ inputSchema: {
334
+ text: z.string().min(1).max(2000).describe('評価する訴求文(2000文字まで)'),
335
+ industry: z.enum(['shigyo', 'ec', 'saas']).describe("想定する業種('shigyo'=士業 / 'ec'=EC / 'saas'=BtoB SaaS)"),
336
+ lang: LANG,
337
+ },
338
+ },
339
+ {
340
+ slug: 'ja-readability-check',
341
+ apiPath: '/ja-readability-check/api/check',
342
+ title: '和文可読性チェッカー',
343
+ summary:
344
+ 'URLのページの本文の日本語タイポグラフィを、PC とスマホの画面幅で推定して診断する。1文字だけの孤立行・句読点や閉じ括弧の行頭禁則・1行の文字数(35〜40字の目安)・和文フォントのフォールバック欠けを該当箇所つきで返す。ページとその CSS(8本まで)を取得する。',
345
+ sends: '入力したURL',
346
+ fetches: true,
347
+ slow: true,
348
+ inputSchema: {
349
+ url: URL_PARAM(),
350
+ cpl: z.number().int().min(10).max(80).optional().describe('1行の文字数(10〜80の整数)。省略時は CSS から推定する'),
351
+ lang: LANG,
352
+ },
353
+ },
354
+ {
355
+ slug: 'faq-site-diff',
356
+ apiPath: '/faq-site-diff/api/check',
357
+ title: 'FAQ×サイト 記載差分チェッカー',
358
+ summary:
359
+ 'FAQ・ヘルプページと本体サイトのページ(3件まで)の料金・営業時間・電話番号・日付・「〇日以内」などの記載を突き合わせ、食い違う箇所を返す。FAQ の更新漏れ探しに使う。',
360
+ sends: '入力したURL',
361
+ fetches: true,
362
+ slow: true,
363
+ inputSchema: {
364
+ faq: URL_PARAM('FAQ・ヘルプページのURL'),
365
+ sites: z.array(z.string().min(1).max(2048)).min(1).max(3).describe('比べる本体サイトのページURLの配列(1〜3件。FAQ と同じURLは不可)'),
366
+ lang: LANG,
367
+ },
368
+ },
369
+ {
370
+ slug: 'nap-check',
371
+ apiPath: '/nap-check/api/check',
372
+ title: '会社名・住所・電話の表記ゆれチェッカー(NAP)',
373
+ summary:
374
+ '同じサイトのページ(3件まで・同じオリジン)の表示テキスト・フッター・tel: リンク・JSON-LD から会社名・住所・電話番号・営業時間を拾い、ページ間や構造化データとの表記ゆれ・不一致候補を返す。ローカルSEOの下調べに使う。' +
375
+ '同じIPから10分に10回まで(超えると HTTP 429)。',
376
+ sends: '入力したURL',
377
+ fetches: true,
378
+ slow: true,
379
+ inputSchema: {
380
+ urls: z.array(z.string().min(1).max(2048)).min(1).max(3).describe('照合するページURLの配列(1〜3件・同じサイト)'),
381
+ lang: LANG,
382
+ },
383
+ },
384
+ ];
385
+
386
+ const toolName = (slug) => `app_${slug.replace(/-/g, '_')}`;
387
+
388
+ function buildDescription(d) {
389
+ return [
390
+ d.summary,
391
+ `apps.first-ch.com${d.slug === 'myip' ? '/myip/' : `/${d.slug}/`} と同じ処理(POST ${d.apiPath})。`,
392
+ SENDS(d.sends),
393
+ d.fetches ? FETCHES : '',
394
+ d.ai ? `文面は Cloudflare Workers AI(Cloudflare 上の言語モデル)に渡して判定する。${AI_LIMIT}` : '',
395
+ RESULT,
396
+ ]
397
+ .filter(Boolean)
398
+ .join('');
399
+ }
400
+
401
+ /** server.mjs が登録する定義(name・title・description・inputSchema と呼び出しに使う値) */
402
+ export const APP_TOOLS = DEFS.map((d) => ({
403
+ name: toolName(d.slug),
404
+ slug: d.slug,
405
+ apiPath: d.apiPath,
406
+ summary: d.summary,
407
+ title: `${d.title}[apps.first-ch.com へ送信]`,
408
+ description: buildDescription(d),
409
+ inputSchema: d.inputSchema,
410
+ timeoutMs: d.slow ? SLOW_TIMEOUT_MS : DEFAULT_TIMEOUT_MS,
411
+ ai: Boolean(d.ai),
412
+ }));
413
+
414
+ // ---------------------------------------------------------------------------
415
+ // HTTP 呼び出し
416
+ // ---------------------------------------------------------------------------
417
+
418
+ export class AppsApiError extends Error {
419
+ constructor(message, details = {}) {
420
+ super(message);
421
+ this.name = 'AppsApiError';
422
+ Object.assign(this, details);
423
+ }
424
+ }
425
+
426
+ /** ベース URL を決める(引数 > 環境変数 > 既定)。http(s) 以外・パスつきは受けない */
427
+ export function resolveBaseUrl(raw = process.env[APPS_BASE_URL_ENV]) {
428
+ const value = (raw ?? '').trim() || DEFAULT_APPS_BASE_URL;
429
+ let u;
430
+ try {
431
+ u = new URL(value);
432
+ } catch {
433
+ throw new AppsApiError(`${APPS_BASE_URL_ENV} が URL として読めません: ${value}`);
434
+ }
435
+ if (u.protocol !== 'https:' && u.protocol !== 'http:') {
436
+ throw new AppsApiError(`${APPS_BASE_URL_ENV} は http:// か https:// で指定してください: ${value}`);
437
+ }
438
+ return u.origin;
439
+ }
440
+
441
+ /** API へ送る本文(lang は送らずパスで切り替える。undefined の項目は落とす) */
442
+ export function buildRequestBody(args = {}) {
443
+ const body = {};
444
+ for (const [k, v] of Object.entries(args)) {
445
+ if (k === 'lang' || v === undefined) continue;
446
+ body[k] = v;
447
+ }
448
+ return body;
449
+ }
450
+
451
+ const HINT_BY_STATUS = {
452
+ 429: '回数制限に達しました。しばらく(AI のアプリは10分ほど・1日の上限なら日本時間9時以降)おいてから呼び直してください。',
453
+ 413: '入力が大きすぎます。',
454
+ 502: '相手のサイトに届かなかったか、応答が返りませんでした。',
455
+ };
456
+
457
+ /**
458
+ * 定義1件ぶんの API を呼び、応答の JSON を返す。
459
+ * 失敗(タイムアウト・接続失敗・HTTP エラー・JSON でない応答)は AppsApiError を投げる
460
+ * (MCP ではツールのエラー=isError として呼び出し側に返る)。
461
+ */
462
+ export async function callAppTool(def, args = {}, opts = {}) {
463
+ const fetchImpl = opts.fetch ?? globalThis.fetch;
464
+ const base = resolveBaseUrl(opts.baseUrl ?? process.env[APPS_BASE_URL_ENV]);
465
+ const version = opts.version ?? '0.0.0';
466
+ const timeoutMs = opts.timeoutMs ?? def.timeoutMs ?? DEFAULT_TIMEOUT_MS;
467
+ const path = `${args.lang === 'en' ? '/en' : ''}${def.apiPath}`;
468
+ const url = `${base}${path}`;
469
+
470
+ const controller = new AbortController();
471
+ const timer = setTimeout(() => controller.abort(), timeoutMs);
472
+ let res;
473
+ let text;
474
+ try {
475
+ try {
476
+ res = await fetchImpl(url, {
477
+ method: 'POST',
478
+ headers: {
479
+ 'content-type': 'application/json',
480
+ accept: 'application/json',
481
+ 'user-agent': `first-ch-tools-mcp/${version}`,
482
+ },
483
+ body: JSON.stringify(buildRequestBody(args)),
484
+ // POST の 301/302 を追うと GET に化けて 405 になるため、転送は追わずにエラーにする
485
+ redirect: 'manual',
486
+ signal: controller.signal,
487
+ });
488
+ text = await res.text();
489
+ } catch (err) {
490
+ if (controller.signal.aborted) {
491
+ throw new AppsApiError(
492
+ `${url} の応答が ${Math.round(timeoutMs / 1000)} 秒以内に返りませんでした(タイムアウト)。時間をおいて呼び直してください。`,
493
+ { code: 'timeout', url },
494
+ );
495
+ }
496
+ const cause = err?.cause?.code || err?.cause?.message || err?.message || String(err);
497
+ throw new AppsApiError(`${url} に接続できませんでした(${cause})。ネットワーク接続を確認してください。`, {
498
+ code: 'network',
499
+ url,
500
+ });
501
+ }
502
+ } finally {
503
+ clearTimeout(timer);
504
+ }
505
+
506
+ const status = res.status;
507
+ if (status >= 300 && status < 400) {
508
+ throw new AppsApiError(
509
+ `${url} が転送(HTTP ${status} → ${res.headers.get('location') ?? '転送先なし'})を返しました。API のパスが変わった可能性があります。`,
510
+ { code: 'redirect', status, url },
511
+ );
512
+ }
513
+ if (text.length > MAX_RESPONSE_CHARS) {
514
+ throw new AppsApiError(`${url} の応答が大きすぎます(${text.length} 文字)。`, { code: 'too_large', status, url });
515
+ }
516
+
517
+ let data;
518
+ try {
519
+ data = JSON.parse(text);
520
+ } catch {
521
+ const type = res.headers.get('content-type') ?? '不明';
522
+ const head = text.replace(/\s+/g, ' ').trim().slice(0, 200);
523
+ throw new AppsApiError(
524
+ `${url} の応答が JSON ではありません(HTTP ${status}・content-type: ${type})。先頭: ${head || '(空)'}`,
525
+ { code: 'not_json', status, url },
526
+ );
527
+ }
528
+
529
+ if (!res.ok) {
530
+ const errCode = data && typeof data === 'object' && typeof data.error === 'string' ? data.error : '';
531
+ const message = data && typeof data === 'object' && typeof data.message === 'string' ? data.message : '';
532
+ const parts = [`apps.first-ch.com がエラーを返しました(HTTP ${status}${errCode ? `・${errCode}` : ''})`];
533
+ if (message) parts.push(message);
534
+ if (HINT_BY_STATUS[status]) parts.push(HINT_BY_STATUS[status]);
535
+ throw new AppsApiError(parts.join(': '), { code: errCode || `http_${status}`, status, url, body: data });
536
+ }
537
+ return data;
538
+ }