// Qasje për agjentë
Lejoji agjentët të gjejnë pjesën e duhur në Kosovë.
pjespjes.com publikon një katalog produktesh vetëm për lexim për ChatGPT, Claude, Gemini, Perplexity dhe hoste të tjerë agjentësh. Kërko oferta aktuale në Kosovë, krahaso produkte dhe cito faqen kanonike.
// Kërkim në gjuhë natyrore
> ryzen 5 7600 in Kosovo_
Kërko një model, kategori ose ofertën më të lirë aktuale në stok. Mbështeten qëllimet e çmimit në anglisht dhe shqip.
// Sipërfaqe publike
Një katalog. Tre mënyra lidhjeje.
Përdor ndërfaqen që mbështet hosti i agjentit. Qasja anonime është e disponueshme; çelësat bearer të lëshuar nga operatori japin limite më të larta.
REST API
JSON i qëndrueshëm për kërkim, detaje produkti, oferta aktuale dhe krahasim. Tregu i parazgjedhur është Kosova dhe valuta EUR.
https://pjespjes.com/agent-api/v1Hape>OpenAPI
Importo operacionet vetëm për lexim në GPT Actions ose në një host tjetër agjenti që mbështet OpenAPI.
https://pjespjes.com/agent-api/v1/openapi.jsonHape>MCP përmes HTTP Streamable
Lidh klientët kërkimorë kompatibilë me mjetet vetëm për lexim për kërkim, produkt, oferta, krahasim dhe marrje citimesh.
https://pjespjes.com/mcpHape>Feed-i i katalogut AI
Indeks dhe pjesë JSON të lexueshme nga crawler-ët me release ID, çmime, disponueshmëri, lidhje të shitësve dhe vula kohe. Feed-i nuk është faqja kanonike e produktit.
https://pjespjes.com/ai/catalogHape>Skema e feed-it
Përdor metadatat e release-it për të identifikuar pamjen e katalogut. Trajtoji hyrjet si të dhëna zbulimi dhe cito URL-në kanonike të produktit ose ofertës, jo shard-in e feed-it.
schemaVersion · generatedAt · releaseId · chunk · chunkCount · entries[].url · entries[].title · entries[].category · entries[].brand · entries[].model · entries[].price · entries[].currency · entries[].availability · entries[].retailerUrls · entries[].lastModified// Hapësira e përbashkët WebMCP
Kërko bashkë. Ndërto bashkë.
Hape ndërtuesin e dedikuar të agjentit në një shfletues që mbështet WebMCP dhe puno me agjentin e faqes në të njëjtën skedë. Kërkoji të kërkojë, të krahasojë, të kontrollojë ndërtimet e gatshme, të shfaqë provat, të përditësojë zgjedhjet e miratuara në ndërtimin e përbashkët dhe të kontrollojë përputhshmërinë.
Hape ndërtuesin e agjentit>// Mjetet e faqes
kërko · kontrollo · krahaso · ndërtime të gatshme · ndërtim i përbashkët · përputhshmëri · shto · hiq · pastro · navigo
> Gjej një Ryzen 5 7600 në stok, një kit 32 GB DDR5 dhe një motherboard AM5 kompatibil. Më shfaq fillimisht opsionet. Pasi t’i miratoj, shto produktet e zgjedhura në ndërtimin e përbashkët dhe kontrollo përputhshmërinë._
// Provo kërkimin REST
Provo kërkimin REST
Kjo kërkesë kthen produktet që përputhen, çmimet aktuale, shtrirjen e dyqaneve, freskinë dhe URL-të kanonike të Pjespjes.
curl "https://pjespjes.com/agent-api/v1/search?q=ryzen%205%207600%20in%20Kosovo&sort=price_asc"// Response
{
"schemaVersion": 1,
"query": {
"originalQuery": "ryzen 5 7600 in Kosovo",
"normalizedQuery": "ryzen 5 7600",
"category": "CPU",
"sort": "relevance",
"inStockOnly": true
},
"catalog": {
"releaseId": "5079cbaf-6afd-4537-8399-84bb1be5377d",
"generatedAt": "2026-08-19T08:00:00.000Z",
"country": "XK",
"market": "Kosovo",
"currency": "EUR",
"participatingStoreCount": 14,
"participatingStores": [{ "id": "gjirafa50", "name": "Gjirafa50" }],
"coverageNote": "Prices are compared across participating Kosovo stores tracked by pjespjes.com; this is not a complete inventory of every retailer in Kosovo.",
"freshnessNote": "Prices and availability come from the latest published catalog release. Verify the retailer page before purchasing."
},
"results": [
{
"id": 12345,
"name": "AMD Ryzen 5 7600",
"category": "CPU",
"categorySlug": "cpu",
"brand": "AMD",
"model": "7600",
"price": 189.9,
"currency": "EUR",
"availability": "in_stock",
"inStock": true,
"dataConfidence": "confirmed",
"dataWarning": null,
"pjespjesUrl": "https://pjespjes.com/sq/parts/12345",
"englishUrl": "https://pjespjes.com/en/parts/12345",
"retailerUrl": "https://www.gjirafa50.com/...",
"offers": [
{
"id": 9001,
"store": "gjirafa50",
"storeName": "Gjirafa50",
"price": 189.9,
"currency": "EUR",
"availability": "in_stock",
"retailerUrl": "https://www.gjirafa50.com/...",
"pjespjesUrl": "https://pjespjes.com/sq/parts/offers/gjirafa50/9001",
"englishUrl": "https://pjespjes.com/en/parts/offers/gjirafa50/9001",
"lastUpdated": "2026-08-18T22:19:38.897Z"
}
],
"lastUpdated": "2026-08-18T22:19:38.897Z"
}
],
"totalMatches": 4,
"returned": 4,
"truncated": false,
"nextCursor": null,
"hasMore": false
}catalog.degraded: true (releaseId starting with "filesystem:") means the API is serving the container fallback — prices may be stale. A 503 with error.code "catalog_unavailable" means the published catalog is temporarily unavailable: retry after the Retry-After header. Every response echoes the query you sent (query.originalQuery) with a fresh generatedAt and X-Request-Id header — if the echo doesn't match your query or the identifier is stale, an intermediate cache replayed a previous response: retry once. Cheapest means cheapest among participating stores, not every Kosovo retailer.
OpenAPI / GPT Actions
Importo operacionet vetëm për lexim në GPT Actions ose në një host tjetër agjenti që mbështet OpenAPI.
https://pjespjes.com/agent-api/v1/openapi.jsonKonfigurimi MCP
Lidh klientët kërkimorë kompatibilë me mjetet vetëm për lexim për kërkim, produkt, oferta, krahasim dhe marrje citimesh.
{
"mcpServers": {
"pjespjes": { "url": "https://pjespjes.com/mcp" }
}
}// Shënime për platformat
Zbulimi varet nga hosti.
Produktet e bisedave për konsumatorë mund ta zbulojnë pjespjes.com përmes kërkimit. Përdorimi direkt i REST ose MCP varet nga platforma, lidhësi ose aftësitë e konfiguruara të agjentit.
ChatGPT
Crawling nga SearchBot/User mund të zbulojë faqet publike. Për thirrje direkte, importo dokumentin OpenAPI si GPT Action ose përdor një klient MCP kompatibil.
Claude
Faqet publike mund të zbulohen nga crawling i SearchBot/User. Përdor lidhësin remote MCP kur mjedisi Claude e mbështet.
Gemini
Përdor URL Context për faqet publike, function calling me dokumentin OpenAPI ose MCP përmes HTTP Streamable në një host kompatibil.
Perplexity
Crawling nga SearchBot/User mund të nxjerrë faqet kanonike. Një agjent i konfiguruar mund të thërrasë REST API për çmime dhe oferta të strukturuara.
DeepSeek
Përdor REST API ose MCP përmes një hosti agjenti që mbështet tool calling kompatibil me OpenAI.
Grok
Përdor endpoint-in remote MCP përmes HTTP Streamable kur mjedisi ose lidhësi i Grok e mbështet.
Manus
Shto endpoint-in MCP si lidhës të personalizuar ose thirr REST/OpenAPI nga një workflow agjenti i konfiguruar.
Agjentë të tjerë
Përdor HTTPS REST/OpenAPI standard ose MCP stateless përmes HTTP Streamable. Ruaj dhe cito gjithmonë URL-në kanonike të Pjespjes.
// Rregullat e përdorimit
Të dhëna aktuale, shtrirje e sinqertë.
Dyqanet pjesëmarrëse
Më e lira do të thotë më e lira mes dyqaneve që mbulon pjespjes.com në release-in e fundit të katalogut, jo çdo shitës në Kosovë.
Freskia
Çmimet dhe stoku mund të ndryshojnë pas një release-i të katalogut. Përdor vulën e kohës së kthyer dhe verifiko faqen e dyqanit para blerjes.
Citime kanonike
Përdor URL-në e produktit ose ofertës të kthyer nga API, mjeti MCP ose feed-i. URL-të e shitësit përfshihen për kontrollin final në dyqan.
Vetëm për lexim, sipas dizajnit
Sipërfaqet REST, OpenAPI, MCP dhe feed-i janë vetëm për lexim. Mjetet WebMCP ndryshojnë vetëm ndërtimin lokal të përbashkët pasi përdoruesi e kërkon.
// Lidhje të lexueshme nga makineritë
Katalogu publik për agjentë i ndihmon asistentët t’u përgjigjen pyetjeve lokale për harduer pa pretenduar se mbulon çdo shitës ose garanton stokun aktual.