ucp-setup
/ucp-setup
Zakłada projekt UCP: szkielet serwera sprzedawcy lub klienta platformy z profilem discovery, instalacją SDK i strukturą projektu.
- Autor
- OrcaQubits ↗
- Repozytorium
- agentic-commerce-skills-plugins ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 14.09.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 7
Brak sygnałów. Repozytorium zmienione 14.09.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Zakłada projekt UCP: szkielet serwera sprzedawcy lub klienta platformy z profilem discovery, instalacją SDK i strukturą projektu.
Oryginalny opis (EN)
Set up a UCP project — scaffold a merchant server or platform client with discovery profile, SDK installation, and project structure. Use when starting a new UCP implementation.
Jak działa
- Before writing any code
- What to scaffold
Podgląd SKILL.md
--- name: ucp-setup description: Set up a UCP project — scaffold a merchant server or platform client with discovery profile, SDK installation, and project structure. Use when starting a new UCP implementation. allowed-tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch, WebFetch --- # UCP Project Setup ## Before writing any code 1. **Web-search** `site:ucp.dev specification overview` to confirm the latest spec version. 2. **Fetch** the latest SDK READMEs: - Python: https://github.com/Universal-Commerce-Protocol/python-sdk - JS/TS: https://github.com/Universal-Commerce-Protocol/js-sdk 3. **Fetch** the sample servers for reference architecture: - https://github.com/Universal-Commerce-Protocol/samples ## What to scaffold ### 1. Determine the role Ask the user: are they building a **Business** (merchant server that exposes checkout), a **Platform** (AI agent that drives checkout), or both? ### 2. Install the SDK - **Python**: Clone the official python-sdk repo and use `uv sync`, or install FastUCP via `pip install fastucp-python` for decorator-based approach. **Note**: `fastucp-python` is a **community/third-party** package, not an official UCP SDK. - **JS/TS**: `npm install @ucp-js/sdk` for TypeScript types and Zod schemas. - Always verify the latest install instructions from the live GitHub README before running. ### 3. Discovery profile (`/.well-known/ucp`) Every Business MUST publish a discovery profile. This is the **first thing to implement**. The profile declares: - Protocol version - Services (which transport bindings are supported, with endpoint URLs) - Capabilities (checkout, orders, identity linking — each with version and schema URI) - Extensions (fulfillment, discount, buyer consent, AP2 — each declaring which capability they extend) - Payment handlers (accepted payment methods with configuration) - Signing keys (EC P-256 public keys for webhook signatures) **Fetch** https://ucp.dev/latest/specification/overview/ and https://developers.google.com/merchant/ucp/guides/ucp-profile for the exact current schema before generating the profile. ### 4. Project structure (Business server) ``` my-ucp-server/ ├── app/ │ ├── main.py (or index.ts) # Server entrypoint │ ├── discovery.py # /.well-known/ucp endpoint │ ├── checkout/ │ │ ├── routes.py # Checkout CRUD + complete + cancel │ │ ├── models.py # Checkout data models (from SDK) │ │ └── negotiation.py # Capability negotiation logic │ ├── orders/ │ │ ├── routes.py # Order management │ │ ├── webhooks.py # Webhook delivery + signing │ │ └── models.py │ ├── payments/ │ │ ├── handlers.py # Payment handler configuration │ │ └── processing.py # Credential processing │ ├── fulfillment/ │ │ └── routes.py # Fulfillment extension logic │ └── common/ │ ├── headers.py # UCP-Agent, Idempotency-Key parsing │ ├── errors.py # UCP error/message model │ └── crypto.py # JWT signing for webhooks ├── tests/ │ └── conformance/ # Conformance test runner ├── .well-known/ │ └── ucp (or served dynamically) ├── .env # API keys, signing key paths └── pyproject.toml (or package.json) ``` ### 5. Environment configuration - Store signing private keys securely (env vars or secrets manager) - Never hardcode payment handler credentials - Use `.env` + `.gitignore` for all secrets ### 6. Verify setup - Serve the discovery profile and validate its JSON against the schema from https://ucp.dev/latest/specification/reference/ - Use the UCP Playground at https://ucp.dev/latest/specification/shopping/playground/ to test discovery step
Wersje
W bazie nie ma innych skilli o nazwie ucp-setup.
Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.
Migawka bazy z 13.11.2026 · wersja paczki c6d97d84c5f6 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90ucp-discount
Implementuje rozszerzenie UCP Discount: stosowanie i walidację kodów rabatowych, śledzenie alokacji i obsługę błędów w checkout UCP. - 100ucp-conformance
Uruchamia i pisze testy zgodności UCP: waliduje implementację względem oficjalnego zestawu testów, obejmującego checkout, zamówienia, realizację, płatności, idempotencję, webhooki i bezpieczeństwo. - 100ucp-project-config
Konfiguruje projekt Unity z terminala: pakiety UPM, ustawienia, tagi, warstwy i budowanie wydań. - 100ucp-assets
Zarządza zasobami projektu Unity z terminala: wyszukuje i przenosi assety, edytuje materiały i sprawdza referencje. - 100ucp
Obsługuje UCP CLI do wyszukiwania, porównywania, kupowania i śledzenia produktów u internetowych sprzedawców oraz konfiguracji i diagnostyki lokalnego profilu UCP, koszyka, checkoutu i zamówień. - 100ucp-agent-ready
Publikuje i naprawia profil UCP, dzięki któremu agenty AI odkryją sklep i zrealizują w nim zakup, z weryfikacją.