Power.fi Product Search & Store Stock Skill

Power.fi Product Search & Store Stock

Search the Power.fi product catalog and check per-store stock using their internal REST API. No browser or authentication required.

Quick Start

Search for products:

./scripts/search.py "kahvinkeitin"
./scripts/search.py "televisio" --limit 20
./scripts/search.py "kuulokkeet" --json
./scripts/search.py "pölynimuri" --sort lth

Check store stock for a product:

./scripts/store_stock.py 3060434
./scripts/store_stock.py 3060434 --postal-code 33100
./scripts/store_stock.py 3060434 --store "Itis"
./scripts/store_stock.py 3060434 --in-stock --json

How It Works

The Power webshop at power.fi has a JSON REST API for product listings. The search script calls this API directly over HTTPS, bypassing the need for a browser.

The API requires no authentication.

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, rating, category, barcode, 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
az — Name A–Z
za — Name Z–A

Programmatic Use

Import the search functions in Python:

from scripts.search import search_products, extract_products

raw = search_products("kahvinkeitin", limit=5)
products = extract_products(raw)
for p in products:
    print(p["title"], p.get("price", "N/A"))

Key Product Fields

| Field | Description | | ------------------ | ---------------------------------------------------------------- | | title | Product name | | manufacturerName | Brand / manufacturer | | price | Current price (EUR, incl. VAT) | | previousPrice | Previous price before discount | | vatlessPrice | Price excluding VAT | | categoryName | Product category | | stockCount | Online stock count | | storesStockCount | Total physical store stock | | barcode | EAN / GTIN barcode | | url | Relative product URL (prefix https://www.power.fi) | | productReview | Object with overallAverageRating and overallTotalReviewCount | | productImage | Object with basePath and variants[] |

Image URLs

Images use the pattern:

https://www.power.fi{basePath}/{filename}

where basePath and filename come from the productImage field.

Store Stock Lookup

Check per-store availability for a specific product using its product ID (found in search results or product URLs).

Basic usage

./scripts/store_stock.py PRODUCT_ID

Shows all stores sorted by distance from Helsinki (postal code 00100).

Options

--postal-code CODE — Sort by distance from a postal code (default: 00100)
--store NAME — Filter by store name (case-insensitive substring)
--in-stock — Show only stores with stock > 0
--json — Output raw JSON

Programmatic use

from scripts.store_stock import get_store_stock

stores = get_store_stock(3060434, postal_code="33100")
for s in stores:
    print(s["name"], s["storeStockCount"])

Key Store Fields

| Field | Description | | ------------------- | ---------------------------------------------- | | storeId | Unique store identifier | | name | Store name (e.g. "POWER Itis Helsinki") | | address | Street address | | city | City | | storeStockCount | Number of units in stock at this store | | storeDisplayStock | Display stock count | | storeAvailability | 0 = not available, 1 = low stock, 2 = in stock | | clickNCollect | Whether click & collect is available | | distance | Distance in km from the given postal code | | workingSchedule | Array of opening hours per day |

API Reference

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

Agent Skills: Power.fi Product Search & Store Stock

Install this agent skill to your local

Skill Files