Technolife

io.github.sepehr071v0.1.0更新於 Oct 3, 2026

Unofficial read-only Technolife: search electronics, compare sellers and installment prices, deals.

概覽

AI 產生的概覽

以唯讀方式查詢 Technolife 電子產品商店的商品、賣家報價、分期價格、規格、評價與優惠。

功能
提供 19 個唯讀工具,查詢 Technolife 網站的公開端點:可依價格、庫存、品牌或分類篩選的商品搜尋,最便宜的現貨報價,逐一比較各賣家的現金價、分期價與先買後付價,規格與最多五項商品的並排比較,顧客評價,目前折扣與活動,賣家信譽,門市、配送與常見問題資訊,以及地址地理編碼。商品以 TLP-60492 之類的代碼識別,賣家代碼類似 TLS-15172。所有工具都回傳精簡的結構化 JSON。
適用情境
適合讓助理研究 Technolife 上的電子產品價格、找出最便宜的現貨報價、比較賣家、保固與分期成本,或在使用者到網站購買前查看規格、評價與目前折扣。
執行需求
以本機 stdio 程序執行,使用 uvx technolife-mcp 或 pip install technolife-mcp 安裝;需要 uv Python 工具以及連線 technolife.com 的網路。不需要帳號、登入或 API 金鑰。選用環境變數 TECHNOLIFE_MCP_PROXY 可為每個請求設定 HTTP 代理;系統代理設定會被忽略。
安裝前請注意
設計上為唯讀:不登入、不儲存購物車、不碰訂單或付款端點,因此無法下單購買。它會向 technolife.com 的公開端點發出請求,價格、庫存與網站行為可能隨時變動。選用的 TECHNOLIFE_MCP_PROXY 值可能內含代理憑證,應視為機密。任何價格都不含運費。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Technolife,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

📱 technolife-mcp

Let your AI agent shop around on Technolife.
Search phones, laptops and appliances, compare every seller's cash and installment price,
read specs and reviews, and catch today's deals, all from Claude, Cursor or Copilot.

[PyPI] [Python] [CI] [MCP Registry] [License: MIT]

[Install in Cursor] [Install in VS Code]

Quick start · What it can do · Tools · FAQ · فارسی


Why

On Technolife one product page hides several sellers, colors, warranties and three price lists (cash, installment, buy now pay later). Finding the best offer means clicking through each of them. An agent with technolife-mcp reads them all at once:

You: Where is the Lenovo IdeaPad Slim 3 i3 1315U cheapest on Technolife, and what does it cost in installments?

Agent: calls tl_suggest(query="IdeaPad Slim 3 i3 1315U") → tl_product(product_code="TLP-60492")

SellerCashInstallmentBuy now pay laterWarranty
ایران پشتیبان125,000,000128,750,000135,000,00018 months
چیتک شاپ129,500,000133,385,000139,860,00018 months
دیباکام130,000,000133,900,000140,400,00018 months (Dibacom)

ایران پشتیبان is cheapest in every price list and ships the next working day; device insurance adds 2,375,000. Want me to check the exact total with insurance using tl_price_basket?

Real tool output from 2026-10-03; prices change all the time. Prices are in Toman.

What it can do

  • 🔎 Search the whole catalog with prices, stock, rating, price range and brand/category filters
  • 💸 Find the cheapest in-stock offers, re-sorted on the real price after discount
  • 🏷️ Compare sellers of one product: price per color, warranty, stock, delivery time, seller reputation
  • 💳 See installment prices (installment and buy now pay later) next to cash, and price a basket with insurance
  • 📋 Read specs and compare up to 5 products side by side
  • ⭐ Check quality with customer reviews, star distribution and the site's AI review summary
  • ⚡ Catch deals: the main discount list, timed deals (تکنو تایم) and current campaigns
  • 🔒 Read-only by design: no login, no basket, no orders, no payment

Quick start

You need uv.

Claude Code
bash
claude mcp add technolife -- uvx technolife-mcp
Claude Desktop

Settings → Developer → Edit Config, then add:

json
{  "mcpServers": {    "technolife": { "command": "uvx", "args": ["technolife-mcp"] }  }}
Cursor

Click Install in Cursor above, or add the Claude Desktop block to ~/.cursor/mcp.json.

VS Code (Copilot agent mode)

Click Install in VS Code above, or add to .vscode/mcp.json:

json
{  "servers": {    "technolife": { "type": "stdio", "command": "uvx", "args": ["technolife-mcp"] }  }}
Anything else

It's a standard stdio MCP server: run uvx technolife-mcp, or pip install technolife-mcp and run technolife-mcp.

Then just ask:

  • "Cheapest in-stock Lenovo laptop with 16 GB RAM on Technolife?"
  • "Compare the iPhone 16 and iPhone 17: price, camera, battery."
  • "Which deals on Technolife have more than 50% off right now?"
  • ارزان‌ترین گوشی سامسونگ با قیمت اقساطی در تکنولایف؟

How it works

text
  AI agent  (Claude, Cursor, Copilot, ...)      │      │  MCP over stdio      ▼  technolife-mcp  (runs on your machine)      │      │  HTTPS (GraphQL)      └──────▶  www.technolife.com

technolife-mcp runs locally and calls the same public endpoints the technolife.com website uses. There's no hosted server in between, no API key, and nothing about you is sent anywhere else.

Tools

Products are identified by codes like TLP-60492 and sellers by TLS-15172. List tools return the best offer per product; tl_product returns every seller, color and price list.

🔎 Search (4)
ToolWhat it does
tl_searchSearch with prices, stock, rating; filters for price, brand, category; category/brand facets with their codes
tl_find_cheapestCheapest in-stock products for a search, one flat list sorted by the real price
tl_suggestProduct name → product codes (typeahead)
tl_find_brandBrand name → brand filter code and brand page
🗂️ Catalog (3)
ToolWhat it does
tl_categoriesFind category pages by name, list the top level, or a category's sub-pages
tl_category_productsProducts of a category, brand or promotion page, sorted and filtered
tl_category_filtersA page's brands, categories, price range and attribute filters (RAM, screen, CPU, ...) with codes
📦 Product (4)
ToolWhat it does
tl_productEvery offer: seller, color, warranty, stock, delivery, insurance, installment prices, specs
tl_compare2-5 products side by side: price, stock, rating, every spec
tl_reviewsCustomer reviews, star distribution and the AI summary with pros and cons
tl_price_basketExact total for seller items: discounts, insurance, quantity limits, cash vs installment
⚡ Deals and sellers (3)
ToolWhat it does
tl_dealsCurrent discounts (biggest percent first) and timed home-page deals
tl_campaignsCurrent campaigns, or one campaign's sections and products
tl_sellerA seller's rating, on-time and fault-free percentages, and its products
ℹ️ Shop info (5)
ToolWhat it does
tl_store_infoPhysical stores, shipping methods and costs, 7-day returns, payment methods
tl_faqSearch the help-center FAQ
tl_shop_reviewsCustomer reviews of the shop itself
tl_find_locationAddress or landmark → coordinates, province and city
tl_reverse_geocodeCoordinates → address, province, city and neighbourhood

All 19 tools are annotated readOnlyHint: true and return compact structured JSON, so they don't flood the agent's context.

Good to know

  • Prices are in Toman, as on the site (1 Toman = 10 Rial). final_price is after discount; discount_pct is computed from the two prices, because the site's own percent label is sometimes missing.
  • Ratings are 0–5; null means not rated yet. Review and shop-review dates are Jalali, as the site shows them.
  • Installments: the same seller item costs a few percent more in the installment and buy-now-pay-later price lists; tl_product shows all three and tl_price_basket totals any of them.
  • Shipping cost is not included anywhere: Technolife only prices shipping for a logged-in address. tl_store_info(topic="shipping") has the rules.
  • Price sorting: the site's price order is approximate (timed deals lag), so price sorts are re-sorted on the real price.
  • Persian queries match best (آیفون 16, لپ تاپ لنوو). Category search treats Arabic ي/ك and half-space vs space as equal.

FAQ

A phone search returns phone cases first

Sort by price and accessories win. tl_search and tl_find_cheapest return the matching categories with their codes; the agent passes the phone one back as category_code (e.g. 1 for mobile phones).

Can it place an order for me?

No, and that's deliberate. It has no login and never saves a basket or touches order or payment endpoints. tl_price_basket only asks the server for prices. The agent finds the best offer; you buy on the site.

I get "did not answer in time" or "Could not reach"

Technolife sometimes resets connections; the server retries a failed connection once (timeouts are not retried). If it keeps failing, check your connection or set TECHNOLIFE_MCP_PROXY. Normal system proxy variables are ignored on purpose, because direct calls are the fastest.

Claude Desktop says uvx is not found

Use the full path to uvx (where uvx on Windows, which uvx on macOS/Linux) as command.

How do I debug what the agent sees?
bash
npx @modelcontextprotocol/inspector uvx technolife-mcp

Configuration

VariableDefaultMeaning
TECHNOLIFE_MCP_PROXYunsetHTTP proxy for every request, e.g. http://user:pass@host:port

فارسی

technolife-mcp به دستیار هوش مصنوعی شما (Claude، Cursor، Copilot و ...) اجازه می‌دهد در تکنولایف جستجو کند، قیمت نقدی و اقساطی همه فروشندگان یک کالا را مقایسه کند، مشخصات فنی و نظرات را بخواند و تخفیف‌های فعال را پیدا کند.

  • فقط خواندنی است: وارد حساب نمی‌شود، سبد خرید ذخیره نمی‌کند و سفارش ثبت نمی‌کند.
  • قیمت هر رنگ، فروشنده و گارانتی را همراه با قیمت اقساطی و هزینه بیمه نشان می‌دهد.
  • همه قیمت‌ها به تومان است.
  • روی سیستم خود شما اجرا می‌شود و به هیچ سرور واسطی داده نمی‌فرستد.

نصب در Claude Code:

bash
claude mcp add technolife -- uvx technolife-mcp

بعد بپرسید: «ارزان‌ترین لپ تاپ لنوو با ۱۶ گیگ رم در تکنولایف و قیمت اقساطی آن چقدر است؟»

Development

bash
git clone https://github.com/sepehr071/technolife-mcp && cd technolife-mcpuv syncuv run pytest            # offline, against recorded responsesuv run pytest -m live    # real APIuv run ruff check .

Tools live in src/technolife_mcp/search.py, catalog.py, product.py, offers.py and info.py; each is a typed async function with a docstring that tells the agent when to use it. Issues and PRs are welcome, especially new tools and fixes for API changes.

Releases: bump the version in pyproject.toml and server.json, then push a v* tag. GitHub Actions tests, publishes to PyPI and the MCP Registry, and creates the GitHub Release.

Disclaimer

Unofficial and not affiliated with or endorsed by Technolife. It uses the public endpoints of the technolife.com website, which can change without notice. Please keep request rates reasonable.

License

MIT

來源:README.md,提交 0f680eb

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v0.1.0最新Oct 3, 2026