English Français العربية

io.github.charistas/posokanei-mcp

السجل الرسمي التجارة الإلكترونية

Unofficial read-only MCP server for Greek supermarket price data from PosoKanei.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package posokanei-mcp
Claude Code 
claude mcp add posokanei-mcp -e 'POSOKANEI_API_BASE=<POSOKANEI_API_BASE>' -e 'POSOKANEI_CACHE_TTL_MS=<POSOKANEI_CACHE_TTL_MS>' -e 'POSOKANEI_MIN_INTERVAL_MS=<POSOKANEI_MIN_INTERVAL_MS>' -e 'POSOKANEI_TIMEOUT_MS=<POSOKANEI_TIMEOUT_MS>' -- npx -y posokanei-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "posokanei-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "posokanei-mcp@0.1.1"
            ],
            "env": {
                "POSOKANEI_API_BASE": "<POSOKANEI_API_BASE>",
                "POSOKANEI_CACHE_TTL_MS": "<POSOKANEI_CACHE_TTL_MS>",
                "POSOKANEI_MIN_INTERVAL_MS": "<POSOKANEI_MIN_INTERVAL_MS>",
                "POSOKANEI_TIMEOUT_MS": "<POSOKANEI_TIMEOUT_MS>"
            }
        }
    }
}

متغيرات البيئة

  • POSOKANEI_API_BASE Optional PosoKanei API base URL override.
  • POSOKANEI_CACHE_TTL_MS Optional cache TTL in milliseconds.
  • POSOKANEI_MIN_INTERVAL_MS Optional minimum delay between outbound PosoKanei API requests.
  • POSOKANEI_TIMEOUT_MS Optional outbound request timeout in milliseconds.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. posokanei-mcp
  2. Status
  3. Installation
  4. Tools
  5. Configuration
  6. Development
  7. License

posokanei-mcp

Unofficial read-only MCP server for supermarket product and price data from PosoKanei.

This server lets MCP-compatible clients ask questions such as:

  • Search for supermarket products by name.
  • Look up a product by barcode.
  • Compare current retailer prices for a product.
  • Compare a small shopping basket across retailers.
  • Browse product categories and retailers.

Status

Early open-source version. The implementation uses public, undocumented endpoints used by the PosoKanei web app. Keep requests modest and cache-friendly.

This project is not affiliated with, endorsed by, or operated by PosoKanei, gov.gr, or any Greek public authority.

Installation

Add it to your MCP client configuration:

{
  "mcpServers": {
    "posokanei": {
      "command": "npx",
      "args": ["-y", "posokanei-mcp"]
    }
  }
}

For local development:

{
  "mcpServers": {
    "posokanei": {
      "command": "node",
      "args": ["/absolute/path/to/posokanei-mcp/dist/index.js"]
    }
  }
}

Build first:

npm install
npm run build

Tools

ToolPurpose
search_productsSearch products by text.
get_productGet details and retailer prices for a product id.
lookup_barcodeFind product prices by EAN/GTIN barcode.
list_products_by_categoryList category products, sorted by unit price by default.
list_categoriesReturn a simplified category tree.
list_retailersList known retailers.
get_price_historyFetch product detail with history when available.
compare_competitorsFetch comparable/competitor product data when available.
compare_basketCompare a small basket across retailers.
get_statsReturn high-level dataset stats.

Configuration

Optional environment variables:

VariableDefaultPurpose
POSOKANEI_API_BASEhttps://api.posokanei.gov.grAPI base URL.
POSOKANEI_CACHE_TTL_MS300000In-memory cache TTL.
POSOKANEI_MIN_INTERVAL_MS250Minimum delay between outbound API requests.
POSOKANEI_TIMEOUT_MS15000Request timeout.

Development

npm install
npm run typecheck
npm test

The test suite mocks the PosoKanei API. It should not require live network access.

License

MIT

الأسئلة الشائعة

ما هو io.github.charistas/posokanei-mcp؟

Unofficial read-only MCP server for Greek supermarket price data from PosoKanei.

كيف أثبّت io.github.charistas/posokanei-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add posokanei-mcp -e 'POSOKANEI_API_BASE=<POSOKANEI_API_BASE>' -e 'POSOKANEI_CACHE_TTL_MS=<POSOKANEI_CACHE_TTL_MS>' -e 'POSOKANEI_MIN_INTERVAL_MS=<POSOKANEI_MIN_INTERVAL_MS>' -e 'POSOKANEI_TIMEOUT_MS=<POSOKANEI_TIMEOUT_MS>' -- npx -y posokanei-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.charistas/posokanei-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.charistas/posokanei-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.charistas/posokanei-mcp؟

ينشره charistas. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.