VF

viktorfa/finn_mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

22 stars 15 forks Качество 67 Тренд 18

Неофициальный MCP для норвежского вторичного рынка FINN.no

Обзор

Сервер Model Context Protocol (MCP) для поиска и просмотра норвежских маркетплейсов — FINN.no и Klarna Price Guide. - с фильтрами для категории, цены, состояния, местоположения, цвета, размера одежды и близости на основе радиуса - включая описание, изображения, информацию о продавце и ключевые характеристики - с фильтрами для изготовления, типа топлива, типа кузова, трансмиссии, привода колес, пробега, года и цены - с полными спецификациями (двигатель, пробег, VIN, регистрация и т.д.) - с фильтрами для класса лодки, длины, мощности двигателя / типа / топлива, года и цены - с полными характеристиками (длина, ширина, скорость, двигатель, материалы и т. д.) - для обнаружения мест и подсчета результатов - включая цены, кровати, удобства, правила дома и изображения - для новых продуктов в норвежских ритейлерах с самыми низкими ценами и предупреждениями о падении цен - с индивидуальными предложениями, статусом акций, доставкой, оценками доставки, ссылками на покупку и данными о тенденциях цен CLI предоставляет те же инструменты и параметры, что и MCP-сервер, без запуска сервера.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP) для поиска и просмотра норвежских маркетплейсов — FINN.no и Klarna Price Guide.

Особенности

FINN.no Torget (вторичный рынок)

Поиск с фильтрами для категории, цены, состояния, местоположения, цвета, размера одежды и близости по радиусу ** Подробности товара**, включая описание, изображения, информацию о продавце и ключевые характеристики

FINN.no Автомобили Поиск с фильтрами для изготовления, типа топлива, типа кузова, трансмиссии, привода колеса, пробега, года и цены ** Детали товара** с полными спецификациями (двигатель, пробег, VIN, регистрация и т.д.)

###Финансовые лодки Поиск с фильтрами для класса лодки, длины, мощности двигателя/типа/топлива, года и цены ** Детали изделия** с полными характеристиками (длина, ширина, скорость, двигатель, материалы и т.д.)

###FINN.no Дома отдыха ** Автозаполнение ** для определения местоположения и подсчета результатов ** Детали недвижимости**, включая цены, кровати, удобства, правила дома и изображения

Руководство по ценам Klarna (prisguiden.no) **Поиск новых продуктов в норвежских ритейлерах с самыми низкими ценами

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

FINN.no MCP Server

A Model Context Protocol (MCP) server for searching and browsing Norwegian marketplaces — FINN.no and Klarna Price Guide.

Features

FINN.no Torget (secondhand marketplace)

  • Search with filters for category, price, condition, location, colour, clothing size, and radius-based proximity
  • Item details including description, images, seller info, and key specs

FINN.no Cars

  • Search with filters for make, fuel type, body type, transmission, wheel drive, mileage, year, and price
  • Item details with full specs (engine, mileage, VIN, registration, etc.)

FINN.no Boats

  • Search with filters for boat class, length, engine power/type/fuel, year, and price
  • Item details with full specs (length, width, speed, engine, materials, etc.)

FINN.no Holiday Homes

  • Destination autocomplete to discover locations and result counts
  • Property details including pricing, beds, facilities, house rules, and images

Klarna Price Guide (prisguiden.no)

  • Search for new products across Norwegian retailers with lowest prices and price drop alerts
  • Product details with individual offers, stock status, shipping, delivery estimates, purchase links, and price trend data

Usage

CLI

The CLI exposes the same tools and parameters as the MCP server, without starting a server. Run it from the checkout with node src/cli.js (or pnpm cli). Installing the package exposes the finn command.

node src/cli.js --help
node src/cli.js search_finn_torget --help
node src/cli.js search_finn_torget --query "harrington" --price_to 1500 --shipping
node src/cli.js get_finn_torget_item --finn_code 343932826
node src/cli.js search_finn_cars --fuel Elektrisk --price_to 300000
node src/cli.js search_klarna --query "FiiO K11"

Parameter names match MCP inputs, including underscores. Repeat array flags, for example --condition 2 --condition 3. Boolean flags such as --shipping enable the filter; omit them to leave it off. For structured inputs, use --json instead of parameter flags:

node src/cli.js search_finn_torget --json '{"query":"jakke","condition":["2","3"]}'

Successful calls print JSON to stdout for piping into tools such as jq. Errors go to stderr and exit with status 1. Help is generated from the shared tool schemas.

Claude Code

Add to .mcp.json in your project root (or ~/.claude/.mcp.json for global access):

{
  "mcpServers": {
    "finn-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["github:viktorfa/finn_mcp"]
    }
  }
}

Alternative runners:

# bunx
"command": "bunx", "args": ["github:viktorfa/finn_mcp"]

# pnpm dlx
"command": "pnpm", "args": ["dlx", "github:viktorfa/finn_mcp"]

Claude Desktop

Add to your Claude Desktop config and restart Claude.

{
  "mcpServers": {
    "finn-mcp": {
      "command": "npx",
      "args": ["github:viktorfa/finn_mcp"]
    }
  }
}

Config file locations:

Открыть полный README на GitHub

Установка

npx github:viktorfa/finn_mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "finn-mcp": { "type": "stdio", "command": "npx", "args": ["github:viktorfa/finn_mcp"] } } }