Agent skill
verkkokauppa
Search products on the Verkkokauppa.com Finnish webshop. This skill uses the Verkkokauppa search API directly, requiring no browser. Use when the user asks to "search Verkkokauppa", "find products on verkkokauppa.com", "verkkokauppa product search", "check Verkkokauppa prices", or mentions searching the Verkkokauppa store.
Install this agent skill to your Project
npx add-skill https://github.com/akaihola/skills-akaihola/tree/main/verkkokauppa
SKILL.md
Verkkokauppa.com Product Search
Search the Verkkokauppa.com product catalog using their internal search API. No browser or authentication required.
Quick Start
Run the search script to find products:
./scripts/search.py "näyttö"
./scripts/search.py "kuulokkeet" --limit 20
./scripts/search.py "näytönohjain" --json
./scripts/search.py "kannettava" --sort price
How It Works
The Verkkokauppa.com webshop uses a search backend at search.service.verkkokauppa.com.
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 random UUID v4 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, rating, 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 --page 2
--limit N— Number of results (default: 10)--page N— Page number, 1-based (default: 1)
Sorting
./scripts/search.py "search term" --sort price
-score— Relevance (default)price— Price low to high-price— Price high to low-popularity— Most popular-rating— Highest rated-releaseDate— Newest-discountPercentage— Biggest discount
Programmatic Use
Import the search functions in Python:
from scripts.search import search_products, extract_products
raw = search_products("näyttö", limit=5)
products = extract_products(raw)
for p in products:
print(p["name"], p.get("price_current", "N/A"))
Key Product Fields
| Field | Description |
|---|---|
name |
Product name |
price_current |
Current selling price (EUR) |
price_original |
Original price before discount |
discount_percent |
Discount percentage |
brand |
Brand name |
category |
Product category |
rating |
Average rating |
review_count |
Number of reviews |
url |
Full product URL |
image |
Product image URL (CDN) |
product_id |
Internal product ID |
Image URLs
Images are served via Verkkokauppa CDN with full URLs:
https://cdn.verk.net/images/...
API Reference
See references/api.md for full API documentation including endpoint details,
all parameters, and response structure.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
akaihola/skills-akaihola
youtube-to-markdown
Convert a YouTube video into clean, readable Markdown using its free auto-generated captions (no paid API needed). Use when the user asks to "convert YouTube video to markdown", "get transcript from YouTube URL", "summarise this video", or wants to turn YouTube subtitles/captions into readable text. Prefer this over youtube-transcription when the video already has auto-generated subtitles — it's free and faster. Accepts YouTube URLs.
akaihola/skills-akaihola
brave-search
Search the web using Brave Search API. Use when the user asks to "search the web", "look up current information", "find news about", "research a topic online", "check prices online", or needs up-to-date facts that may not be in the model's training data. Requires BRAVE_SEARCH_API_KEY. Supports structured web results (pages, FAQs, news, videos) and an optional AI summarizer.
akaihola/skills-akaihola
clasohlson
Search products on the Clas Ohlson Finland webshop (clasohlson.com/fi/). This skill uses the Voyado Elevate (Apptus eSales) search API directly, requiring no browser. Use when the user asks to "search Clas Ohlson", "find products on clasohlson.com", "clas ohlson product search", "check Clas Ohlson prices", or mentions searching the Finnish Clas Ohlson store.
akaihola/skills-akaihola
bauhaus
Search products on the Bauhaus webshop (bauhaus.fi). This skill uses the Algolia search API with automatic key refresh. Use when the user asks to "search Bauhaus", "find products on bauhaus.fi", "bauhaus product search", "check Bauhaus prices", or mentions searching the Bauhaus store.
akaihola/skills-akaihola
library
akaihola/skills-akaihola
email-mailbox-analyzer
Analyzes email mailbox usage by extracting IMAP configurations and running imapdu to generate detailed usage reports. Use this skill when you need to analyze email storage, identify large mailboxes, and generate CSV reports.
Didn't find tool you were looking for?