Openapi APIマーケットプレイス（ヨーロッパ最大の認定APIマーケットプレイス）のサービスを利用・統合するためのエージェントスキルです。
npx skills add openapi/openapi-skills
リポジトリ構成
| フォルダ | 目的 |
|---|---|
knowledge/ | 厳選されたナレッジベース：企業プロファイル、サービスカタログ、プラットフォームガイド（認証、課金、サンドボックス）、FAQ、リファレンス、サービス別のエンドポイントドキュメント、ベンダー提供のOpenAPI仕様 |
skills/ | エージェントスキル（ドメインごとに1フォルダ、各SKILL.mdを含む） |
ナレッジとスキルの分離
2つのフォルダは厳密に役割が分離されています。
knowledge/はビルド時マテリアルです。 スキルを作成・調整する（Openapiの変更があったときにスキルを更新する）ために使用される厳選された情報の塊です。このリポジトリのメンテナーが参照するものであり、スキルを実行するエージェントが参照するものではありません。skills/は自己完結型の成果物です。 各SKILL.mdはナレッジからデータを取り込んでいますが、決してナレッジにリンクしてはいけません。エージェントはこのリポジトリのknowledge/フォルダが利用できなくてもスキルを使用できなければなりません。- スキル内での外部参照は許可されますが、決して
knowledge/を経由してはいけません。 スキルは公式ソース（例：https://console.openapi.com/oas/en/<service>.openapi.jsonの正規仕様、ドキュメントポータル、ステータスページ）を直接指し示します。ローカルコピーを指すことはありません。
メンテナンスフロー：最初に公式ソースからknowledge/を更新し、その後、関連する内容を影響を受けるSKILL.mdファイルに反映します。
スキル
| スキル | カバー範囲 |
|---|---|
| openapi-auth | OAuth v2トークンのライフサイクル、スコープ、ウォレット、使用状況統計（他のすべてのスキルで必要） |
| openapi-company | 企業情報：イタリア、EU、全世界 |
| openapi-documents | 公的文書：商業登録証明書、貸借対照表、DURC、異議申立（DocuEngine、Visure Camerali、Visengine） |
| openapi-risk | 信用スコア、CRIFレポート、KYC、ネガティブイベント |
| openapi-trust | メール、電話、IP、URL、PEC、税コード、ナンバープレートの検証 |
| openapi-geo | ジオコーディング、郵便番号、イタリアの地籍情報、不動産評価 |
| openapi-messaging | SMS v2、PEC、Massive REM、Poste Italiane経由の郵便 |
| openapi-esignature | eIDAS電子署名および認定タイムスタンプ |
| openapi-invoicing | 電子請求書（Invoice、SDI）および請求書支払い |
| openapi-automotive | ナンバープレートによる車両データ |
| openapi-utilities | 為替レート、HTML-to-PDF、.itドメイン、管理型RAG |
認証情報
スキルは環境変数にOPENAPI_EMAILとOPENAPI_API_KEY（oauth.openapi.comのアカウント認証情報）、または準備済みのOPENAPI_TOKEN Bearerトークンを必要とします。詳細はknowledge/platform-guide.mdを参照してください。
コントリビューション
コントリビューションは常に歓迎します！バグの報告、新機能の提案、ドキュメントの改善、コードの提供など、どのような形でもご協力いただけると幸いです。
作者
- Francesco Bianco (@francescobianco)
- Openapi Team (@openapi-it)
パートナー
Openapiを利用している、またはこのプロジェクトに貢献しているパートナーをご紹介します：
- Blank
- Credit Safe
- Deliveroo
- Gruppo MOL
- Jakala
- Octotelematics
- OTOQI
- PWC
- QOMODO S.R.L.
- SOUNDREEF S.P.A.
私たちの取り組み
私たちはオープンソースを信じており、その信念に基づいて行動しています。Linux FoundationのSilver Memberになったのは、日常的に構築しているエコシステムを正式に支援したいと考えたからです。オープンスタンダード、オープンコラボレーション、オープンガバナンスは、私たちの仕事のスタイルであり、ソフトウェアに対する考え方の一部です。
ライセンス
このプロジェクトは MIT License の下でライセンスされています。
MITライセンスは寛容なオープンソースライセンスであり、ソフトウェアのすべてのコピーまたは実質的な部分に元の著作権表示および本許諾表示が含まれている限り、ソフトウェアの自由な使用、コピー、変更、統合、公開、配布、サブライセンス、および/または販売を許可します。
詳細については、MIT Licenseページで完全なライセンス文を参照してください。