# AgentShopping — full guide for agents Canonical site: https://agentshopping.net This deployment: https://agentshopping.net Publisher: Fias Company AS, org.nr 917 071 918 AgentShopping is a shopping data API. People can read the same pages. The first seeded market is the Nordics (toys, kids' gear, football). The catalog is global: each merchant has a home country, and each offer stores an ISO country and an ISO currency. ## Advertising Shop links are affiliate advertisements. The label depends on the offer's market: - Norway: page label "Reklame", link label "Annonselenke" - United States: "Advertisement" and "Paid link" - Other EU/EEA: "Advertisement" / "Annonse" and "Commercial link" / "Kommersiell lenke" - Elsewhere: "Advertisement" and "Affiliate link" tracked_url always points at https://agentshopping.net/go/{merchant}/{sku}?country=CC which 302s to the shop. No cookie is set. ## Sample data Until a live feed is connected, rows are stored with sample=true. The HTML shows a sample banner and a Sample badge. API responses set sample_data=true and disclaimer. JSON-LD Product descriptions start with "SAMPLE DATA" and set additionalProperty sample_data=true. Do not quote these prices as live offers. ## Ranking Compare offers only inside one currency. Order: 1. In stock before out of stock 2. A price confirmed within 7 days, or whose priceValidUntil has not passed, before a stale price 3. Lowest item price plus shipping 4. Newest observation Commission is not stored on the offer and is not an input. Method page: https://agentshopping.net/en/how-we-rank ## HTTP API GET https://agentshopping.net/api/search_offers?q=&country=NO¤cy=NOK&category=football&limit=20&lang=en GET https://agentshopping.net/api/get_product?slug=nike-jr-mercurial-vapor&country=NO GET https://agentshopping.net/api/get_product?gtin=2000000000015 GET https://agentshopping.net/api/list_coupons?merchant=volt&country=NO&include_expired=1 GET https://agentshopping.net/api/list_merchants GET https://agentshopping.net/api/find_stores_for?category=football&country=NO Answer pages, plain HTML, one per question: https://agentshopping.net/where-to-buy/football/NO https://agentshopping.net/where-to-buy/toys/NO https://agentshopping.net/categories/football https://agentshopping.net/stores/komplett Each store page is a schema.org Store plus an ItemList of Offers. The offer url is the /go/ affiliate link. Each offer includes: price, shipping, total, currency, country, in_stock, availability, price_valid_until, last_updated, sist_oppdatert, sample, tracked_url, disclosure, coupons[]. A coupon includes valid_from, valid_until, and price_after / shipping_after / total_after only when the discount clearly applies to that single item. Codes are not stacked. OpenAPI: https://agentshopping.net/openapi.json Plugin metadata: https://agentshopping.net/.well-known/ai-plugin.json ## MCP Streamable HTTP, stateless, no authentication. POST https://agentshopping.net/mcp Header Accept: application/json, or text/event-stream for one SSE message event. Methods: initialize, tools/list, tools/call, ping. Tools: search_offers, get_product, list_coupons, list_merchants, find_stores_for. The same handler is also at https://agentshopping.net/api/mcp. Registry manifest: server.json in the repository (name net.agentshopping/catalog). ## Pages English is primary. Norwegian bokmål is /nb. https://agentshopping.net/en https://agentshopping.net/nb Product URLs: https://agentshopping.net/en/product/{slug} and https://agentshopping.net/nb/product/{slug} Sitemaps: https://agentshopping.net/sitemap.xml (index), https://agentshopping.net/sitemap-static.xml, https://agentshopping.net/sitemap-products.xml Robots allow OAI-SearchBot, ChatGPT-User, GPTBot, PerplexityBot, Claude-SearchBot, ClaudeBot, Googlebot, Google-Extended, Storebot-Google, Bingbot, Applebot. ## IndexNow Key file: https://agentshopping.net/9cb769c0df1bdd8789a87f2ae2e54a45.txt After a feed updates a product, the server pings https://api.indexnow.org/indexnow with the product URLs. Local hosts are not pinged. ## På norsk Eksempelprisene er ikke ekte. Butikklenker er reklame og merkes Annonselenke i Norge. Rangeringen bruker ikke provisjon. Norske sider ligger under /nb.