aigentify

aigentify

パッケージと API 型 · クイックスタート · 設定

aigentify は、製品ディレクトリや公開ウェブサイトを管理する開発者向けの、オープンソースのエージェント対応状況監査ツールです。 スコア、個別のチェック項目、対応可能な課題を提示します。 TypeScript ライブラリ、コマンドラインインターフェース（CLI）、Model Context Protocol（MCP）サーバーを使って、公開用のアーティファクトテキストも生成できます。

インストール

npm install aigentify

Node.js 20 以降が必要です。このパッケージには、直接依存するランタイム依存関係が5つあり、TypeScript の型宣言が含まれています。 価格：0米ドル。

最初の監査を実行する

既存の製品ディレクトリから、次のコマンドを実行します。

npx aigentify audit .

ディレクトリの監査に環境変数、認証情報、.env ローダーは必要ありません。 レポートは .: <score>/100 で始まり、各チェックのステータスを列挙して、最後に Gaps: を表示します。 スコアが低くても監査は完了しており、コマンドの失敗ではありません。

製品情報を使って公開ガイドを生成します。

npx aigentify gen agents-md --name Example --description 'A product API.' --repository https://example.com --price 0 --price-currency USD --out agents.md

正常に生成されると agents.md が作成されます。公開する前に、プレースホルダーと製品固有の指示を確認してください。

import { auditTarget, generate } from 'aigentify';

const report = await auditTarget('.');
console.log(report.score, report.gaps);
console.log(generate('offer', {
  name: 'Example',
  description: 'A product API.',
  repository: 'https://example.com',
  offer: { price: 0, priceCurrency: 'USD' },
}));

これを audit.mjs として保存し、node audit.mjs を実行すると、スコアと構造化されたオファーが出力されます。

仕組み

Directory files or URL responses
              |
       Snapshot and checks
              |
       Score + ordered gaps
              |
  Fix product facts -> generate text -> publish -> audit again

URL の監査では、検出用エンドポイントにアクセスし、外部レジストリに問い合わせます。ディレクトリの監査では、アプリケーションを実行せずにファイルを調べます。

開発の背景

開発者には、通常のウェブサイトチェックと併せて、エージェントの検出用ファイルを確認する手段が必要です。 Lighthouse はウェブ品質を監査し、axe-core はアクセシビリティを確認します。 aigentify は、エージェント向けのマニフェスト、公開指示、オファー、検出の根拠に焦点を当てています。

比較

2026-10-14 時点で確認した対象範囲です。これらのツールは、隣接する監査ニーズに対応しています。

対象範囲	aigentify	Lighthouse	axe-core
主な対象	エージェント対応状況	ウェブページの品質	アクセシビリティ
ここでの入力	ディレクトリまたは URL	ウェブページ	HTML ベースのインターフェース
ここで生成される出力	エージェント向けアーティファクトテキスト	監査レポート	アクセシビリティの結果

対応範囲

実装には、27個の監査チェック、6個のジェネレーター、3個の外部レジストリプローブが定義されています。 これらはソースコードで確認された機能であり、すべての対象がチェックに合格することを示すものではありません。 この改訂にあたり、認証情報が必要なプラットフォーム検証は行っていません。

対象または連携	ステータス	範囲
AGENTS.md、MCP discovery、server.json	実装済み	存在、フィールド、公開安全性のヒューリスティック
Schema.org のオファー	実装済み	JSON-LD の検出と緊急性を示す表現のチェック
llms.txt、sitemap.xml	実装済み	利用可能性
OpenAPI、エージェントマニフェスト、/agents	実装済み	URL の検出チェック
Personal Agent Protocol（Poppy）	実装済み	Draft 0.1 の検証。検出専用のジェネレーター
HTTP の検出とクローラーの応答	実装済み	Markdown、リンク、ステータス、本文、スキーマ、レート制限ヘッダー
認証ガイド、API カタログ、Agent2Agent カード	実装済み	ドキュメントの形式または利用可能性
AI プラグインマニフェスト	実装済み	名前、API、認証フィールド
Wikidata	実装済み	公式ウェブサイトの検索
npm	実装済み	パッケージ検索、名前とホームページの照合
Official MCP Registry	実装済み	サーバー検索、名前とホストの照合
Next.js	テンプレート	agents-route --framework next はルートの指示を出力します

外部チェックでは、根拠が見つからない場合や結論が出ない場合に警告を返します。 URL のみを対象とするチェックは、ローカルディレクトリに対して na を返します。

一般的なユースケース

1. パッケージのメンテナーが、エージェント向けファイルを npm に公開する前に Node.js ディレクトリを監査します。
2. Next.js の開発者が /agents.md のルート指示を生成し、デプロイした URL を監査します。
3. MCP サーバーの作成者が server-json を生成し、パッケージまたはリモート設定を確認します。
4. API チームが、公開 URL 上の OpenAPI の検出情報、認証ガイド、Agent2Agent カードを調査します。
5. プロダクト開発者が、Wikidata、npm、Official MCP Registry の検出情報を確認します。

機能

• ディレクトリと URL の監査では、スコア、チェック項目、優先順位付きの不足項目が返されます。
• アーティファクトの生成では、サービスをデプロイせずにテキストが返されます。
• audit --json を使うと、JSON 出力をスクリプトで利用できます。
• 設定を通じて、生成するアーティファクト間でプロダクト情報を共有できます。

実行環境

ライブラリは、auditTarget、formatAuditReport、scoreAuditChecks、defineConfig、defaultConfig、およびジェネレーター関数をエクスポートします。 ライブラリは Node.js 上で実行してください。監査にはファイルシステム API を使用します。

CLI コマンド	動作
audit [target]	デフォルトは . です。--json を指定するとレポートを出力します
init	AGENTS.md、server.json、auth.md を作成します。--force を指定すると上書きできます
gen <artifact>	テキストを出力します。--out を指定するとファイルに書き込みます
mcp	stdio サーバーを起動します

6 つのアーティファクト名は、agents-md、server-json、offer、agents-route、auth-md、poppy です。 agents-route は --framework static または --framework next を受け付けます。

スタンドアロンサーバーは npx aigentify-mcp で起動します。 このサーバーのツールは 2 つあり、audit は { target }、gen は { artifact, params } を受け付けます。

設定

CLI で生成する場合は、aigentify.config.ts、aigentify.config.js、または aigentify.config.mjs を作成します。

import { defineConfig } from 'aigentify';

export default defineConfig({
  name: 'Example',
  description: 'A product API.',
  repository: 'https://example.com',
  npmPackage: 'example-product',
  offer: { price: 0, priceCurrency: 'USD' },
});

デフォルト設定、または名前付きの aigentifyConfig をエクスポートします。 ライブラリと MCP での生成では、パラメーターを直接指定できます。

提供・動作上の制限

スコアには重み付けされたヒューリスティックを使用します。満点でも、エージェントとの互換性、検索順位、検出が保証されるわけではありません。 クローラーのチェックでは 1 つのエージェント User-Agent を使用し、すべてのクローラーをテストするわけではありません。 リクエストのタイムアウトは 8 秒です。レジストリのエラーにより、検出情報が確定できない場合があります。 監査ではテキストを取得しますが、ブラウザーの JavaScript は実行しません。 生成されるファイルにはデフォルト値とテンプレートが含まれており、確認が必要です。 認証テンプレートは API キーの動作を説明するものであり、認証を実装するものではありません。 Poppy ジェネレーターが出力するのは検出専用データであり、認証済みのエージェント接続や API 接続ではありません。 init は --force が設定されていない限り既存のファイルを保持します。ファイルをデプロイすることはありません。

統合ガイド

• Next.js ルートテンプレート：指示を生成し、その後、自分でルートを公開します。
• MCP stdio の設定：クライアントを aigentify-mcp に接続します。
• 共有プロダクト設定：名前、URL、オファー情報を設定します。

ステータス

バージョン 0.5.0 は 0.x リリースです。インターフェースやチェック項目は変更される場合があります。 サポートについては、npm パッケージに記載されている GitHub の Issue チャンネルをご利用ください。 公開事例は、まだこの README には掲載されていません。

よくある質問

aigentify は何を監査しますか？

aigentify は、エージェント対応を示すシグナルについて、ローカルディレクトリまたは公開 URL を監査します。 レポートには、スコア、チェック項目、実行可能な改善点が含まれます。

どの統合が検証されていますか？

aigentify のソースコードには、Wikidata、npm、Official MCP Registry のプローブが実装されています。 このリライトでは実装を確認しましたが、認証情報を使った実環境での検証は実施していません。

aigentify はマネージドサービスを提供しますか？

aigentify は、Node.js プロセス内または stdio MCP サーバーとして実行されます。 生成されたアーティファクトは、ご自身で公開し、ホストしてください。

aigentify は Lighthouse とどう違いますか？

aigentify は、エージェント向けの検出情報をチェックし、アーティファクトのテキストを生成します。 Lighthouse は、ウェブページの品質を監査します。

aigentify と axe-core の違いは何ですか？

aigentify は、エージェントへの対応状況と公開されている検出用ファイルを確認します。 axe-core は、HTML ベースのインターフェースのアクセシビリティを評価します。

aigentify に API キーは必要ですか？

ディレクトリの監査や公開レジストリのプローブに、aigentify は API キーを使用しません。 生成される認証ガイドは、製品向けのテンプレートです。

スコアが 100 なら、互換性が保証されますか？

aigentify がスコア化するのは実装済みのヒューリスティックであり、あらゆるエージェントとのエンドツーエンドの互換性ではありません。 サポートするクライアントで、公開済みのインターフェースをテストしてください。

aigentify はウェブサイトを自動で修正できますか？

aigentify はテキストとスターターファイルを生成します。 製品に関する情報を確認し、不足している動作を実装して、変更をデプロイしてください。

ライセンス

MIT。