# Registering a shop on parink.lt (instructions for AI agents)

parink.lt is a Lithuanian price-comparison and buying-advice site. It lists a shop's products
from the shop's own product XML feed — the same file Lithuanian shops already export for
kainos.lt and kaina24.lt. This page tells an agent how to get a shop listed, end to end.

## What the shop needs

1. A public product feed URL (permanent, standard port, HTTP Basic allowed).
   Spec: https://parink.lt/parduotuvems/xml — machine-readable: https://parink.lt/parduotuvems/xml.json
   Accepted roots: <products> or <product_feed>.
2. The shop's website URL and one contact email.

## Step 1 — validate the feed

MCP (endpoint https://parink.lt/mcp, JSON-RPC 2.0 over HTTP):

    tools/call  merchant_validate_feed  { "feed_url": "https://shop.lt/feed.xml" }

REST equivalent:

    POST https://parink.lt/api/merchant/validate   {"feed_url":"https://shop.lt/feed.xml"}

Returns: `ok`, `count` (products found), `ean_pct`, `image_pct`, `category_pct`,
`categories` (sample paths), `sample` (first 5 products), `errors[]` and `warnings[]`
with human-readable Lithuanian messages. Fix every `errors[]` entry before applying;
`warnings[]` reduce how often the shop's products are shown but do not block listing.

The feed is fetched server-side with User-Agent `ParinkXmlImporter/1.0 (+https://parink.lt/parduotuvems/xml)`,
a 20-second timeout and a 15 MB read cap.

## Step 2 — apply

MCP:

    tools/call  merchant_apply  {
      "shop_url": "https://shop.lt",
      "feed_url": "https://shop.lt/feed.xml",
      "contact_name": "Vardas Pavardė",
      "email": "partneriai@shop.lt",
      "phone": "+370 600 00000",
      "note": "12 000 products, home appliances"
    }

REST equivalent: POST https://parink.lt/api/merchant/apply with the same JSON body.
`shop_url` and `email` are required; everything else is optional. When `feed_url` is
given, the application stores the validation report alongside it.

Returns `application_id` and `next_steps`. Applications are reviewed by a human
(≤ 5 applications per hour per IP). There is no auto-approval — do not retry in a loop.

## Step 3 — after approval

The shop is assigned a `shop_key` and a dashboard token. The dashboard lives at
https://parink.lt/parduotuvems/ataskaita?key=<token> and shows clicks per day, billable clicks
(one user per product per 24 h — the same rule kainos.lt uses), top clicked products,
product count and last import status, with CSV export. The token is handed to the shop
directly; agents cannot mint one.

Commercials: the first 60 days of clicks are free; after that the price per
billable click is agreed individually, based on the shop's own dashboard numbers.

## Human page

https://parink.lt/parduotuvems (Lithuanian) carries the same form and the same instant validation.