// Developer portal
Use the same Kosovo PC catalog that powers the site through stable JSON, OpenAPI, MCP, Markdown, and CLI interfaces. Start with the free read-only sandbox, then request higher limits when your integration is ready.
> Sandbox
GET /agent-api/v1/search_
The anonymous search endpoint is the production-safe sandbox: it never changes catalog data, builds, or retailer accounts. It returns structured errors and RateLimit headers so an integration can exercise retry behavior before requesting credentials.
// Credentials
The public agent API and sandbox support anonymous read-only calls. For higher limits, request an operator-issued bearer key or an OAuth 2.0 client-credentials pair through the contact page. Credentials are never returned in a URL or page.
Request credentials// Quickstart
Search with a natural-language query, sort by price when needed, and use the returned canonical URL for citations. Prices and stock are snapshots; verify the retailer before purchase.
curl "https://pjespjes.com/agent-api/v1/search?q=ryzen%205%207600&sort=price_asc"
JavaScript
const client = new PjespjesClient();
await client.search("ryzen 5 7600", { sort: "price_asc" });
Python
client = PjespjesClient()
client.search("ryzen 5 7600", sort="price_asc")v1 is backward-compatible. Responses expose X-Request-Id and rate-limit headers; build-plan retries should send an Idempotency-Key. Treat prices, stock, and lastUpdated as time-sensitive catalog snapshots.
// OAuth 2.0
The authorization server supports the client-credentials grant for the catalog.read scope. Discover the metadata first, then exchange a provisioned client id and secret for a short-lived Bearer token.
OAuth authorization-server metadatacurl -u "$OAUTH_CLIENT_ID:$OAUTH_CLIENT_SECRET" \
-X POST "https://pjespjes.com/oauth/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
--data "grant_type=client_credentials&scope=catalog.read"// Sandbox
The anonymous search endpoint is the production-safe sandbox: it never changes catalog data, builds, or retailer accounts. It returns structured errors and RateLimit headers so an integration can exercise retry behavior before requesting credentials.
Run the sandbox searchLive sandbox
Run a real read-only search
// Install the CLI
npm install -g @pjespjes/cli · pip install pjespjesThe public API is read-only. It does not place orders, process payments, or guarantee retailer stock.
REST
Stable JSON endpoints for search, products, offers, compare, builds, and batch calls.
https://pjespjes.com/agent-api/v1OpenAPI
Import the v1 contract into Actions, typed clients, or your API tooling.
https://pjespjes.com/agent-api/v1/openapi.jsonMCP
Connect a compatible agent host to the read-only Streamable HTTP server.
https://pjespjes.com/mcpSDK / CLI
Use the published JavaScript, CLI, and Python entry points when package release is confirmed.
https://www.npmjs.com/package/@pjespjes/sdkPackage status: v1.1.0 is staged for public release, but npm/PyPI publication is still pending registry credentials. Use the REST/OpenAPI examples until the registry pages show the release; always verify the current version and changelog before installing.
// Machine-readable resources