How do I install the Tokmanni skill?

Run npx skillmds@latest add akaihola/tokmanni in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Tokmanni safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tokmanni?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tokmanni free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tokmanni?

akaihola (@akaihola) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tokmanni by akaihola — Agent Skill

Name: Tokmanni
Rating: 4.2 (5 reviews)
Author: akaihola

Tokmanni

Search products on the Tokmanni webshop (tokmanni.fi). This skill uses the Klevu search API directly, requiring no browser. Use when the user asks to "search Tokmanni", "find products on tokmanni.fi", "tokmanni product search", "check Tokmanni prices", or mentions searching the Tokmanni store.

akaihola Updated Sep 10, 2026

File contents

Tokmanni Product Search

Search the Tokmanni product catalog using their internal Klevu REST API. No browser or authentication required.

Quick Start

Run the search script to find products:

./scripts/search.py "taskulamppu"
./scripts/search.py "pesuaine" --limit 20
./scripts/search.py "porakone" --json
./scripts/search.py "kahvinkeitin" --sort lth

How It Works

The Tokmanni webshop at tokmanni.fi uses a Klevu 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 a public API key embedded in the Tokmanni website frontend.

Using the Search Script

Basic search

./scripts/search.py "search term"

Prints a formatted list of up to 10 products with name, brand, price, stock status, category, SKU, and product URL.

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 10

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

Sorting

./scripts/search.py "search term" --sort lth

rel — Relevance (default)
lth — Price low to high
htl — Price high to low

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"], p.get("salePrice", "N/A"))

Key Product Fields

Field	Description
`name`	Product name
`salePrice`	Current selling price (EUR)
`oldPrice`	Original price before discount
`item_brand_name`	Brand name
`category`	Product category
`sku`	Product SKU / EAN code
`inStock`	Stock status (`"yes"` / `"no"`)
`url`	Full product URL
`cloudinary_image`	Product image URL (Cloudinary)

Image URLs

Images are served via Cloudinary with full URLs in the cloudinary_image field:

https://res.cloudinary.com/tokmanni/image/upload/c_pad,b_white,f_auto,h_328,w_328/d_default.png/{sku}.jpg

API Reference

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

---name: tokmannidescription: Search products on the Tokmanni webshop (tokmanni.fi). This skill uses the Klevu search API directly, requiring no browser. Use when the user asks to "search Tokmanni", "find products on tokmanni.fi", "tokmanni product search", "check Tokmanni prices", or mentions searching the Tokmanni store.---# Tokmanni Product SearchSearch the Tokmanni product catalog using their internal Klevu REST API.No browser or authentication required.## Quick StartRun the search script to find products:```bash./scripts/search.py "taskulamppu"./scripts/search.py "pesuaine" --limit 20./scripts/search.py "porakone" --json./scripts/search.py "kahvinkeitin" --sort lth```## How It WorksThe Tokmanni webshop at `tokmanni.fi` uses a Klevu search backend. The searchscript calls this API directly over HTTPS with JSON responses, bypassing theneed for a browser.The API requires no authentication — only a public API key embedded in theTokmanni website frontend.## Using the Search Script### Basic search```bash./scripts/search.py "search term"```Prints a formatted list of up to 10 products with name, brand, price, stockstatus, category, SKU, and product URL.### JSON output```bash./scripts/search.py "search term" --json```Outputs the raw API response as JSON for programmatic use.### Pagination```bash./scripts/search.py "search term" --limit 20 --offset 10```- `--limit N` — Number of results (default: 10)- `--offset N` — Starting position, 0-based (default: 0)### Sorting```bash./scripts/search.py "search term" --sort lth```- `rel` — Relevance (default)- `lth` — Price low to high- `htl` — Price high to low## Programmatic UseImport the search functions in Python:```pythonfrom scripts.search import search_products, extract_productsraw = search_products("lamppu", limit=5)products = extract_products(raw)for p in products: print(p["name"], p.get("salePrice", "N/A"))```## Key Product Fields| Field | Description ||--------------------|------------------------------------|| `name` | Product name || `salePrice` | Current selling price (EUR) || `oldPrice` | Original price before discount || `item_brand_name` | Brand name || `category` | Product category || `sku` | Product SKU / EAN code || `inStock` | Stock status (`"yes"` / `"no"`) || `url` | Full product URL || `cloudinary_image` | Product image URL (Cloudinary) |## Image URLsImages are served via Cloudinary with full URLs in the `cloudinary_image` field:```https://res.cloudinary.com/tokmanni/image/upload/c_pad,b_white,f_auto,h_328,w_328/d_default.png/{sku}.jpg```## API ReferenceSee `references/api.md` for full API documentation including endpoint details,all parameters, and response structure.

Frequently asked questions