Asinlens

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 7, 2026

Amazon product, seller and search data: details, offers, sales history, ranks and dimensions.

概覽

AI 產生的概覽

連接 Easyparser 託管 Amazon 資料服務的本地橋接,讓助理取得商品、賣家、搜尋、排名與銷售歷史資料,以及帳戶和批次任務檢視。

可以做什麼
  • 取得商品詳情、賣家報價、暢銷排名、包裝尺寸及最長 12 個月的銷售歷史
  • 依關鍵字或搜尋連結搜尋 Amazon,並把 UPC、EAN、GTIN、ISBN、JAN、MINSAN 條碼轉換為 ASIN
  • 讀取賣家資料、商品目錄和單筆買家評價
  • 查看操作目錄、批次任務、批次項目結果、Webhook 投遞紀錄和 API 錯誤紀錄
  • 查詢方案、點數餘額、速率限制和本月依操作的使用情況
適用情境
適合 Amazon 市場調查:競品與價格分析、賣家與供應商查核、需求與季節性趨勢、FBA 費用與運費估算,以及追蹤在 Easyparser 網頁端建立的批次擷取任務。
執行需求
透過 npx 或 Docker 映像以 stdio 在本機執行,需要 Node.js 或 Docker。呼叫會轉送到 Easyparser 託管端點;選用環境變數 EASYPARSER_API_KEY 可附加 bearer 權杖,EASYPARSER_MCP_URL 可覆寫端點。需要能連線到上游服務的網路。
安裝前請注意
呼叫會消耗 Easyparser 帳戶點數,執行多頁或 12 個月歷史等昂貴請求前先確認餘額。選用的 EASYPARSER_API_KEY 會以 bearer 權杖送往上游,請勿寫入共用設定。商品與賣家資料來自第三方託管服務,橋接本身不保存資料。

安裝

在 SourceWeft 中

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

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

其他 MCP 客戶端

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

README

asinlens

asinlens is a small local bridge to Easyparser's hosted MCP server, which turns Amazon pages into structured data: product details and offers, keyword search, barcode-to-ASIN lookup, sales history, Best Sellers Rank, package dimensions, and seller profiles, feedback and catalogues — plus the account's bulk-job, webhook-log, error-log and credit-balance views.

The bridge keeps no Amazon data and scrapes nothing itself. It serves the upstream server's tool list locally, exactly as captured from the live endpoint, and forwards each tool call upstream, returning the result untouched. Every captured tool is a data read: this rebuild adds no write capability.

Tools

Product data:

  • get_product_detail — the full product profile: title, brand, images, bullets, Buy Box price and availability, Prime eligibility, rating, rank, variants, specifications and top reviews. Give either asin or url, never both; optional domain, language, currency, a_plus_content and seller_id. No required arguments.
  • get_product_offers — every seller offer for one product, with price, shipping, condition, fulfilment type and the Buy Box winner. Required: asin. Optional filters include prime, free_shipping, condition and a page range.
  • search_products — keyword or search-URL search with structured listings and refinement filters. Optional sort_by, exclude_sponsored, refinements and a page range. No required arguments.
  • lookup_product — convert a UPC, EAN, GTIN, ISBN, JAN or MINSAN code (or an ASIN) into the matching Amazon ASIN with a product snapshot. Required: identifier and identifier_type.
  • get_sales_history — up to 12 months of weekly trends for traffic, sales, price and rank. Required: asin; history_range picks the depth.
  • get_bestseller_rank — the current Best Sellers Rank in main and sub-categories. Required: asin.
  • get_package_dimensions — exact package size and weight plus the Amazon fee category, for FBA fee and shipping estimates. Required: asin.

Seller data:

  • get_seller_profile — a merchant's legal business name, registered address and feedback trends. Give either seller_id or url. No required arguments.
  • get_seller_products — a seller's full catalogue with prices, Prime status and ratings. Give either seller_id or url. No required arguments.
  • get_seller_feedback — individual buyer feedback entries, filterable by rating and period. Required: seller_id.

Account and bulk monitoring:

  • list_operations — the upstream operation catalog with parameters, credit costs and examples.
  • list_bulk_jobs — bulk extraction jobs and their progress, filterable by status, operation and domain.
  • get_bulk_job_items — the items inside one bulk job. Required: group_id.
  • get_bulk_item_result — the parsed result data of one bulk item (retained 24 hours after completion). Required: item_id.
  • get_bulk_webhook_logs — webhook delivery logs for bulk jobs, optionally scoped to one group_id.
  • get_error_logs — the account's API error logs for real-time and bulk channels.
  • check_credits — plan, credit balance, reset date, rate limits and this month's usage by operation. No arguments.

Configuration

  • EASYPARSER_MCP_URL (optional) — override the upstream endpoint. Defaults to https://mcp.easyparser.com/mcp. (The override hook is this rebuild's own labelled reconstruction.)
  • EASYPARSER_API_KEY (optional) — when set, every upstream request carries an Authorization: Bearer <key> header. When it is not set, no auth header is sent. (This forwarding is also a labelled reconstruction; the original surface was captured keyless, though the registry record declares the Authorization header.)

Forwarding mechanics

On the first tool call the client opens a streamable HTTP session with the upstream: a JSON-RPC initialize request (protocolVersion 2025-03-26, clientInfo name asinlens), then a notifications/initialized notification, then the tools/call request carrying the caller's arguments unchanged. When the upstream answers initialize with an Mcp-Session-Id header, that value rides on every later request of the session, which is reused for the life of the process. Replies may arrive as plain JSON or as server-sent events; both are read.

Successful upstream results pass through verbatim, including any isError flag the upstream sets. Failures — a JSON-RPC error, a non-2xx status, an unreadable response, or a request that cannot be completed — come back as an isError result whose text starts with asinlens error: (this rendering is this rebuild's own labelled reconstruction).

CLI

Each tool is also a subcommand taking one JSON argument string (omit it for tools that take none):

bash
npx @reneturcios/asinlens get_product_offers '{"asin":"B0CJB6V2L5"}'npx @reneturcios/asinlens lookup_product '{"identifier":"724382975021","identifier_type":"UPC"}'npx @reneturcios/asinlens check_creditsnpx @reneturcios/asinlens --version

Exit codes: 0 on success, 1 on an isError result, 2 on a usage error.

MCP server

bash
npx -y @reneturcios/asinlens mcp

MCP client config:

json
{  "mcpServers": {    "asinlens": {      "command": "npx",      "args": ["-y", "@reneturcios/asinlens", "mcp"]    }  }}

Docker

bash
docker run -i ghcr.io/cloudcorprecords/asinlensdocker run --rm ghcr.io/cloudcorprecords/asinlens --version

The container's default command is mcp, so the first form is a stdio MCP server; any other arguments reach the CLI normally.

Development

bash
npm installnpm run buildnpm testnpm run dev

The test suite runs entirely against a stubbed JSON-RPC upstream — no live network calls.

License

MIT — see LICENSE.

來源:README.md,提交 c6f1718

工具

17

get_product_detail

Fetch complete, structured information about a single Amazon product: title, brand, images, feature bullets, description, Buy Box price and availability, Prime eligibility, rating and review count, Best Sellers Rank, category path, variants, specifications, and top reviews. This is the primary tool for product analysis, listing enrichment, and price monitoring. Use this tool when you need a full product profile. If you only need competing seller prices, use get_product_offers instead (cheaper context). If you only need the sales rank, use get_bestseller_rank. If you only need shipping dimensions or the FBA fee category, use get_package_dimensions. Provide EITHER the identifier field OR url — never both. Costs 1 credit; set a_plus_content to true only when the user explicitly asks about enhanced brand content, as it costs 1 extra credit.

輸入參數urlasindomaincurrencylanguageseller_ida_plus_content

get_product_offers

Fetch the list of seller offers for an Amazon product: every merchant selling the item with their price, shipping cost, condition (new/used), fulfillment type (FBA/FBM), and seller rating. Also returns the Buy Box winner. This is the tool for competitive price analysis, reseller monitoring, and availability tracking. Use this tool when the question is about WHO sells the product and at WHAT price. If you need the product's own details (title, images, rating), use get_product_detail instead. Each requested page costs 1 credit. Start with a single page (default) and only increase max_page if the user needs the full offer list. Use the condition and shipping filters to narrow results instead of paginating — it is cheaper.

輸入參數asin必填primedomainmax_pagemin_pageconditionfree_shipping

search_products

Search Amazon by keyword or a full search/category URL and get structured product listings: ASIN, title, price, rating, review count, Prime status, and badges (Best Seller, Amazon's Choice) for each result. Also returns the available refinement filters (category, brand, price range) with their IDs. Use this tool for market research, keyword analysis, and product discovery. If the user already has an ASIN or product URL, do NOT search — use get_product_detail directly. Each page costs 1 credit. One page typically returns 20-40 products, which is enough for most questions. Use sort_by and exclude_sponsored to improve result quality instead of fetching more pages. To filter by category or brand, first run one search and read the refinements field in the response to discover valid filter IDs, then pass them in refinements.

輸入參數urldomainkeywordsort_bycurrencylanguagemax_pagemin_pagerefinementsexclude_sponsored

lookup_product

Convert an external product identifier (UPC, EAN, GTIN, ISBN, JAN, MINSAN) into the corresponding Amazon ASIN, with an essential product snapshot. This is the bridge between manufacturer/retail barcodes and the Amazon ecosystem. Use this tool when the user has a barcode or standard product code and wants to find the matching Amazon listing. Typical workflows: catalog matching, inventory synchronization, converting supplier data into Amazon ASINs. Also accepts ASIN as input type if you need to validate one. You MUST set identifier_type to match the code you have — guessing the wrong type returns no results. UPC is 12 digits, EAN/GTIN is 13, ISBN is 10 or 13 (books). If the user gives a keyword instead of a code, use search_products instead. Costs 1 credit.

輸入參數domainidentifier必填identifier_type必填

get_sales_history

Retrieve a product's historical performance over up to 12 months: weekly aggregated trends for estimated views/traffic, sales, price, and Best Sellers Rank. This is Easyparser's 'time machine' — the deepest competitive-intelligence tool in this server. Use this tool for trend forecasting, seasonality analysis, conversion-rate estimation, and investment/sourcing due diligence. Do NOT use it for a simple current price check — get_product_detail is 5x cheaper for that. IMPORTANT cost rule: the base cost is 5 credits, and each month of history adds 1 credit (3 months = 8 credits, 12 months = 17 credits). Always ask the user how far back they need, or default to 3 months for a quick trend read. The history array in the response is aggregated by WEEK, not by day.

輸入參數asin必填domainhistory_range

get_bestseller_rank

Get a product's current Best Sellers Rank (BSR): its numerical rank in main categories and sub-category node identifiers. A lightweight, single-purpose tool for popularity and demand tracking. Use this tool when you only need the rank — e.g. 'Is this product selling well?' or daily rank monitoring. Lower rank number means higher sales velocity. If you also need price, rating or content, use get_product_detail instead (it includes BSR along with everything else). For historical rank trends, use get_sales_history. Costs 1 credit.

輸入參數asin必填domain

get_package_dimensions

Get a product's precise physical and logistical attributes: package height, width, length, weight, and its Amazon fee category (e.g. Computers, Apparel). This is the FBA fee-estimation and shipping-cost tool. Use this tool when the question is about shipping, storage, FBA fees, or warehouse planning. Do NOT use it for general product info — get_product_detail includes a human-readable dimensions string, but only THIS tool returns the structured fee category and exact measurements needed for fee calculation. Costs 1 credit.

輸入參數asin必填domain

get_seller_profile

Unmask the legal identity and reputation of any Amazon merchant: legal business name, registered business address, and granular feedback trends over 30/90/365 days and lifetime. This is the supplier-verification and brand-protection tool. Use this tool when the user asks 'who is this seller?', 'is this merchant legitimate?', or needs a supplier's legal entity for compliance or invoicing. To see WHAT the seller sells, use get_seller_products. To read individual buyer reviews about the seller, use get_seller_feedback. Provide EITHER seller_id OR url — never both. You can discover a product's seller by calling get_product_offers first. Costs 1 credit.

輸入參數urldomainlanguageseller_id

get_seller_products

Extract a seller's full product catalog: every ASIN they sell with brand, category, price, Prime status, variant counts, and rating data. Also returns dynamic refinement filters (department, shipping, sustainability) for drilling into the catalog. Use this tool for competitor inventory analysis, stock monitoring, and pricing-strategy research. If you need the seller's legal identity or reputation instead of their products, use get_seller_profile. Each page costs 1 credit. Start with one page and use sort_by (e.g. 'exact-aware-popularity-rank' for best sellers first) to surface the most relevant products early. Provide EITHER seller_id OR url — never both.

輸入參數urldomainsort_bylanguagemax_pagemin_pageseller_idexclude_refinements

get_seller_feedback

Read individual buyer feedback entries for an Amazon seller: star ratings, comment text, and dates — filterable by rating range and time period. This is the reputation deep-dive tool. Use this tool when the user wants to read actual buyer comments about a seller, analyze complaint patterns, or audit service quality. For aggregate reputation scores (30/90/365-day percentages) without individual comments, get_seller_profile is sufficient and cheaper in context. Each page costs 1 credit. To find dissatisfied customers, set max_rating to 3 instead of paging through everything.

輸入參數domainmax_pagemin_pageseller_id必填max_ratingmin_ratinghistory_range

list_operations

List all Easyparser operations available in this server, with their parameters, credit costs, and example use cases. Works WITHOUT an API key — call this first to understand what the server can do, or when you are unsure which tool fits the user's question. Also returns the list of supported Amazon marketplace domains.

輸入參數operation

list_bulk_jobs

List the user's bulk extraction jobs with their progress: operation, domain, status, total/completed/failed/invalid item counts, and timestamps. This reads the SAME data as the Bulk Requests page in the Easyparser web app — so it can see and track jobs the user started from the app UI, not just jobs submitted through this MCP server. Use this tool when the user asks about their bulk jobs: "is my job done?", "what bulk jobs are running?", "did the DETAIL batch finish?". Each row includes a group_id — pass it to get_bulk_job_items to drill into individual items, or to get_bulk_webhook_logs to check webhook deliveries. Statuses: pending (queued), processing (running), completed (all items succeeded), partial_success (some items failed or were dropped — check failed_items/invalid_items counts), failed. This tool is free of per-call credits (monitoring endpoints do not consume credits).

輸入參數pagelimitdomainstatusoperationsort_directionbulk_request_id

get_bulk_job_items

Inspect the individual items inside a bulk job: each item's input value (ASIN, keyword, seller ID...), its status (success/failed/invalid/pending/processing), error message if it failed, credit cost, and completion time. Use this tool to debug a job after list_bulk_jobs shows failed_items or invalid_items > 0 — filter with status='failed' or status='invalid' to see exactly which inputs failed and why. Use search_key to locate one specific ASIN inside a large job. The item's item_id can be used with the Data Service (GET /v1/queries/{id}) to fetch its parsed result. This tool is free of per-call credits (monitoring endpoints do not consume credits).

輸入參數pagelimitstatusdate_togroup_id必填date_fromsearch_keysort_direction

get_bulk_item_result

Fetch the parsed result data of a single bulk job item — the actual Amazon data that item produced (product detail, search results, seller profile, etc., depending on the job's operation). This is the same data shown in the item result modal on the Bulk Requests page of the web app. Use this tool after get_bulk_job_items, when the user wants to see the DATA behind a specific item, not just its status. Typical flow: list_bulk_jobs → get_bulk_job_items → get_bulk_item_result. IMPORTANT: bulk results are retained for 24 HOURS after the job completes, then they expire. If the item's data has expired, the tool returns a clear message — suggest re-running that item through the matching real-time tool (e.g. get_product_detail for a DETAIL item) to regenerate the data. This tool is free of per-call credits.

輸入參數item_id必填

get_bulk_webhook_logs

Check webhook delivery logs for bulk jobs: whether the completion notification was delivered to the user's callback_url, delivery status, and timestamps. Use this when a job shows as completed but the user's system never received the webhook — the classic "job finished but my integration didn't fire" debugging case. Scope to one job with group_id (from list_bulk_jobs), or omit it to scan recent deliveries across all jobs. This tool is free of per-call credits.

輸入參數pagelimitstatusdate_togroup_iddate_fromrequest_idsort_directionbulk_request_id

get_error_logs

List the user's API request error logs — the same data shown on the Errors page of the Easyparser web app. Covers both real-time API errors and bulk job errors: each row has the platform, operation, domain, error code, channel (BULK/REALTIME), the request parameters that caused it, and a timestamp. Use this tool when the user asks about failures: "why are my requests failing?", "show me recent errors", "any webhook errors today?", "what went wrong with my DETAIL calls?". Filter by error_channel (BULK or REALTIME), error_code, operation, or domain to narrow down. Each row includes a request_id and the query_params that triggered the error, so you can trace exactly which input failed. This tool is free of per-call credits (monitoring endpoints do not consume credits).

輸入參數pagelimitdomaindate_toorder_byplatformdate_fromoperationerror_codeorder_typeerror_channel

check_credits

Check the Easyparser account: current plan, credit balance (used/remaining/limit), credit reset date, per-minute rate limits, and this month's daily usage breakdown by operation. FREE — this calls the Account API and consumes no credits. Use this before running expensive multi-page or 12-month-history jobs, when the user asks about their quota or plan, or to analyze usage patterns (e.g. 'which operation consumed the most credits this month?'). Requires an API key.

無需輸入參數。

版本歷史

1
  1. v0.1.0最新Nov 4, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分