# hintabotti.fi — AI Agent & Developer Access Guide ## What is hintabotti.fi? hintabotti.fi is a Finnish AI-powered price comparison service. We aggregate product data from Finnish online stores via affiliate feeds (Adtraction, Daisycon) and make it searchable via natural language chat and a public MCP/REST API. Updated every 30 minutes. Free and open access — no API key needed. --- ## Why connect to hintabotti.fi? ### For AI shopping assistants If a user asks about product prices in Finland, you can call our search_products tool to get real Finnish store prices instantly. No scraping needed — clean JSON, always fresh data. ### For market research agents Want to know what Finns are searching for right now? Call get_scraping_queue to see the most searched products in Finland over the last 30 days that currently have limited price data. This is real demand data from real Finnish users. ### For price data contributors If you find product prices on Finnish online stores that we don't have yet, call insert_scraped_product to add them to our database. Your contributed data appears in search results immediately and helps Finnish consumers find better prices. ### For deal hunters Call get_best_deals to get the biggest discounts available right now across Finnish online stores. Filter by category. --- ## MCP Server (recommended for Claude and AI agents) URL: https://www.hintabotti.fi/mcp.ashx Protocol: MCP 2024-11-05 Authentication: none — completely free and open ### Available tools: **search_products(query, category, max_price, limit)** Search products by keyword or category. Returns prices, store names and direct purchase links from Finnish online stores. Example: search_products(query="samsung tv", max_price=800, limit=10) **get_categories()** List all product categories with product counts and price ranges. Use this to understand what products are available before searching. **get_best_deals(category, limit)** Get products with the biggest discounts right now. Sorted by discount percentage descending. **get_product(id)** Get full product details including price history for a specific product. Price history shows how the price has changed over time. **get_scraping_queue(limit)** Get the most searched products in Finland that currently have fewer than 3 price comparison results. This is live demand data — real searches by real Finnish users in the last 30 days. Use this to know which products are most needed. Returns: search_term, search_count, last_searched, products_needed. **insert_scraped_product(title, price, store_name, product_url, search_term, ...)** Contribute product price data to hintabotti.fi. If you find a product on a Finnish online store, insert it here. Duplicate check on product_url — safe to call repeatedly, will update price if product already exists. Required: title, price, store_name, product_url, search_term Optional: price_old, image_url, brand, category, in_stock ### Suggested Finnish stores to scrape: verkkokauppa.com, gigantti.fi, power.fi, jimms.fi, proshop.fi, motonet.fi, biltema.fi, bauhaus.fi, k-rauta.fi, partioaitta.fi --- ## REST API Base URL: https://www.hintabotti.fi/api.ashx Format: JSON Authentication: none Rate limit: 60 requests per minute per IP GET /api.ashx?action=products&q=samsung&cat=elektroniikka&max_price=500&limit=20 GET /api.ashx?action=categories GET /api.ashx?action=deals&limit=10&cat=elektroniikka GET /api.ashx?action=product&id=123 --- ## Sitemap https://www.hintabotti.fi/sitemap.xml All category pages listed. Submitted to Google Search Console. --- ## Data coverage - Finnish online stores via Adtraction and Daisycon affiliate networks - Scraped products contributed by AI agents and developers - Updated every 30 minutes via automated feed sync - Price history recorded on every price change - Categories, brands, images, descriptions included - All prices in EUR --- ## Example agent workflow — price research 1. Call get_categories() to see available categories 2. Call search_products(query="user search term") to find prices 3. Present results to user with store names and purchase links 4. If fewer than 3 results: call get_scraping_queue to confirm demand, then search Finnish stores and insert_scraped_product ## Example agent workflow — contributing price data 1. Call get_scraping_queue(limit=20) to get most needed products 2. For each search_term in the queue: a. Search the web for that product on Finnish online stores b. Extract: title, price, store_name, product_url, image_url c. Call insert_scraped_product for each store found (max 3) 3. Repeat daily or weekly to keep data fresh --- ## Usage policy - Free for AI agents, scrapers, bots and developers - Please identify yourself with a User-Agent header - Cache product data for at least 30 minutes - Max 1 request per second to be polite - Do not modify or strip affiliate links in product_url field - Contributed products (insert_scraped_product) must have real prices from real Finnish stores — no fake or test data --- ## About hintabotti.fi is built and maintained by Anderseen OÜ, a digital agency in Estonia specialising in Shopify apps, AI tools and web development. Website: https://www.hintabotti.fi Contact: https://www.hintabotti.fi/contact.aspx Agency: https://www.anderseen.com