Clas Ohlson Finland Product Search Skill

Clas Ohlson Finland Product Search

Search the Clas Ohlson Finland product catalog using their internal Voyado Elevate (Apptus eSales) REST API. No browser or authentication required.

Quick Start

Run the search script to find products:

./scripts/search.py "taskulamppu"
./scripts/search.py "led lamppu" --limit 20
./scripts/search.py "porakone" --json

How It Works

The Clas Ohlson Finnish webshop at clasohlson.com/fi/ uses a Voyado Elevate (formerly Apptus eSales) search backend. The search script calls this API directly over HTTPS with JSON responses, bypassing the need for a browser.

The API requires no authentication — only random UUID v4 values for session tracking.

Using the Search Script

Basic search

./scripts/search.py "search term"

Prints a formatted list of up to 10 products with name, brand, price, category, and article number.

JSON output

./scripts/search.py "search term" --json

Outputs the raw API response as JSON for programmatic use.

Pagination

./scripts/search.py "search term" --limit 20 --offset 11

--limit N — Number of results (default: 10)
--offset N — Starting position, 1-based (default: 1)

Custom attributes

./scripts/search.py "search term" --attributes name_fi,baseprice,brand

Override which product fields to request. See references/api.md for the full list of available attributes.

Programmatic Use

Import the search functions in Python:

from scripts.search import search_products, extract_products

raw = search_products("lamppu", limit=5)
products = extract_products(raw)
for p in products:
    print(p["name_fi"], p.get("baseprice", "N/A"))

Key Product Attributes

| Attribute | Description | |------------------------|------------------------------------| | name_fi | Product name in Finnish | | baseprice | Price including VAT (EUR) | | brand | Brand name | | mainCategoryName_fi | Primary category | | gridViewImage | Image path (relative) | | article_number | Article number | | description_fi | Product description in Finnish | | campaignStatus | Whether product is on sale |

Image URLs

Image paths from the API are relative. Prefix with:

https://images.clasohlson.com/medias

API Reference

See references/api.md for full API documentation including endpoint details, all parameters, response structure, and the autocomplete/suggestions endpoint.

Agent Skills: Clas Ohlson Finland Product Search

Install this agent skill to your local

Skill Files