Openapi API 마켓플레이스(유럽 최대의 공인 API 마켓플레이스)의 서비스를 사용하고 통합하기 위한 에이전트 스킬입니다.
npx skills add openapi/openapi-skills
저장소 구성
| 폴더 | 용도 |
|---|---|
knowledge/ | 큐레이션된 지식 베이스: 회사 프로필, 서비스 카탈로그, 플랫폼 가이드(인증, 결제, 샌드박스), FAQ, 참고자료, 서비스별 엔드포인트 문서 및 vendor OpenAPI 명세 |
skills/ | 에이전트 스킬, 도메인별로 하나의 폴더, 각각 SKILL.md 포함 |
지식 / 스킬 분리
두 폴더는 엄격하게 분리된 역할을 가집니다:
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 | 공식 문서: 등기부등본(visure camerali), 재무제표, DURC, 항의증서(protesti) (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 팀 (@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 페이지에서 전체 라이선스 텍스트를 확인하세요.