ebay-mcp 2.0.0 → 2.0.2

package/README.md

@@ -5,7 +5,7 @@
 </p>
 
 <p align="center">
-  <strong>The eBay MCP server — give Claude, Cursor, and any AI assistant full access to eBay's Sell APIs. 380 tools for inventory, orders, marketing, and analytics, running locally with your own keys.</strong>
+  <strong>The eBay MCP server — give Claude, Cursor, and any AI assistant full access to eBay's Sell APIs. 379 tools for inventory, orders, marketing, and analytics, running locally with your own keys.</strong>
 </p>
 
 <p align="center"><sub>Unofficial, open-source project — not affiliated with, authorized, or endorsed by eBay Inc.</sub></p>
@@ -20,7 +20,7 @@
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/tools-380-8957e5?logo=ebay&logoColor=white" alt="380 eBay API tools" />
+  <img src="https://img.shields.io/badge/tools-379-8957e5?logo=ebay&logoColor=white" alt="379 eBay API tools" />
   <img src="https://img.shields.io/badge/Sell%20API%20coverage-100%25-success" alt="100% eBay Sell API coverage" />
   <img src="https://img.shields.io/badge/Model%20Context%20Protocol-compatible-000000" alt="Model Context Protocol compatible" />
   <img src="https://img.shields.io/badge/tests-1%2C000%2B%20passing-3fb950?logo=vitest&logoColor=white" alt="Over 1,000 passing tests" />
@@ -33,7 +33,7 @@
 
 ---
 
-**eBay MCP** is a local [Model Context Protocol](https://modelcontextprotocol.io) server that connects AI assistants — [Claude Desktop](https://claude.ai/download), [Claude Code](https://code.claude.com/docs/en/overview), [Cursor](https://cursor.com/), [Cline](https://cline.bot/), [Windsurf](https://windsurf.com/), [Zed](https://zed.dev/), [Continue.dev](https://docs.continue.dev/), [Roo Code](https://roocode.com/), and [Amazon Q Developer](https://aws.amazon.com/q/developer/) — directly to **[eBay's Sell APIs](https://developer.ebay.com/api-docs/sell/static/overview.html)**. It exposes **380 tools** spanning **100% of the eBay Sell, Commerce and Developer APIs it tracks** (356 unique endpoints) for inventory management, order fulfillment, promoted-listings marketing, analytics, and developer tooling. Everything runs on your machine over STDIO or local HTTP — **no cloud relay**, and your eBay credentials never leave your computer.
+**eBay MCP** is a local [Model Context Protocol](https://modelcontextprotocol.io) server that connects AI assistants — [Claude Desktop](https://claude.ai/download), [Claude Code](https://code.claude.com/docs/en/overview), [Cursor](https://cursor.com/), [Cline](https://cline.bot/), [Windsurf](https://windsurf.com/), [Zed](https://zed.dev/), [Continue.dev](https://docs.continue.dev/), [Roo Code](https://roocode.com/), and [Amazon Q Developer](https://aws.amazon.com/q/developer/) — directly to **[eBay's Sell APIs](https://developer.ebay.com/api-docs/sell/static/overview.html)**. It exposes **379 tools** spanning **100% of the eBay Sell, Commerce and Developer APIs it tracks** (356 unique endpoints) for inventory management, order fulfillment, promoted-listings marketing, analytics, and developer tooling. Everything runs on your machine over STDIO or local HTTP — **no cloud relay**, and your eBay credentials never leave your computer.
 
 > **Disclaimer:** Unofficial, third-party project — **not affiliated with or endorsed by eBay Inc.** Provided "as is" without warranty. You are responsible for complying with [eBay's API License Agreement](https://developer.ebay.com/join/api-license-agreement) and [data-handling requirements](https://developer.ebay.com/api-docs/static/data-handling-update.html), keeping your credentials secure, and staying within rate limits. Test in sandbox before production. See [LICENSE](LICENSE).
 
@@ -59,7 +59,7 @@
 
 ## Features
 
-- **380 eBay API tools** — 100% coverage of the eBay Sell APIs across inventory, orders, marketing, analytics, metadata, taxonomy, and developer tooling.
+- **379 eBay API tools** — 100% coverage of the eBay Sell APIs across inventory, orders, marketing, analytics, metadata, taxonomy, and developer tooling.
 - **9 AI clients, auto-configured** — Claude Desktop, Cursor, Zed, Cline, Continue.dev, Windsurf, Roo Code, Claude Code CLI, and Amazon Q Developer.
 - **OAuth 2.0 built in** — full user-token management with automatic refresh, and smart fallback from user tokens (10k–50k req/day) to client credentials (1k req/day).
 - **Resilient by default** — automatic retry with exponential backoff on `429` rate limits, and consistent, loud error surfacing.
@@ -82,7 +82,7 @@ Use this map when deciding which tool family to expose, or when asking an assist
 | `stores` | eBay Store details, store categories (add, rename, move, delete), and category task status | "Show my eBay Store category tree." |
 | `fulfillment` | Orders, shipping fulfillments, refunds, payment disputes, and dispute evidence | "Show unfulfilled orders from the last 7 days." |
 | `logistics` | Shipping quotes, label purchase, shipments, and label download (limited-release Logistics API) | "Get shipping rate quotes for this order." |
-| `browse` | Sold/completed listing search (Finding API) for pricing comps | "What have similar items sold for recently?" |
+| `browse` | Active listing search and item details (Browse API) for market research | "What similar items are listed right now?" |
 | `marketing` | Promoted Listings campaigns, ads, promotions, bidding, and marketing reports | "List my active promoted listing campaigns." |
 | `analytics` | Traffic reports, seller standards, and customer-service metrics | "Show my seller standards profile." |
 | `communication` | Buyer-seller messaging, negotiations, notifications, and feedback | "Show recent buyer messages that need a response." |
@@ -281,7 +281,7 @@ Both talk to the same eBay endpoints — the difference is everything you'd othe
 | Input validation | Zod schemas + TypeScript types on every tool | None — you validate your own payloads |
 | Setup | One wizard (`npm run setup`) | Per-call auth, headers, and marketplace wiring |
 | AI client support | 9 clients auto-configured | Not applicable |
-| API coverage | 380 tools across 100% of the Sell APIs, ready to call | Build each request from the docs |
+| API coverage | 379 tools across 100% of the Sell APIs, ready to call | Build each request from the docs |
 | Hosting | Runs locally, no cloud relay | Your own infrastructure |
 
 ## One-click AI setup
@@ -463,9 +463,9 @@ Auto-configured by `npm run setup`. Requires [Node.js](https://nodejs.org/en)
 ## Available tools
 
 <details open>
-<summary><strong>380 tools by category (100% Sell API coverage)</strong></summary>
+<summary><strong>379 tools by category (100% Sell API coverage)</strong></summary>
 
-**380 tools**, 100% Sell API coverage, organized by category. Each link points to the tool definitions and handlers in [`src/tools/categories/`](src/tools/categories/):
+**379 tools**, 100% Sell API coverage, organized by category. Each link points to the tool definitions and handlers in [`src/tools/categories/`](src/tools/categories/):
 
 | Category | What you can do |
 | --- | --- |
@@ -553,7 +553,7 @@ Common tasks, phrased as you'd ask your AI assistant:
 <details>
 <summary><strong>What is the eBay MCP server?</strong></summary>
 
-A local [Model Context Protocol](https://modelcontextprotocol.io) server that exposes **380 tools** covering **100% of the eBay Sell, Commerce and Developer APIs it tracks** (356 endpoints) to AI assistants — inventory, order fulfillment, marketing, analytics, and developer tools.
+A local [Model Context Protocol](https://modelcontextprotocol.io) server that exposes **379 tools** covering **100% of the eBay Sell, Commerce and Developer APIs it tracks** (356 endpoints) to AI assistants — inventory, order fulfillment, marketing, analytics, and developer tools.
 
 </details>
 
@@ -588,7 +588,7 @@ Interactive [MCP Apps](#interactive-ui-mcp-apps) views only appear on hosts that
 <details>
 <summary><strong>How many eBay APIs and tools does it cover?</strong></summary>
 
-380 tools across 356 unique endpoints — 100% of the eBay Sell, Commerce and Developer APIs it tracks.
+379 tools across 356 unique endpoints — 100% of the eBay Sell, Commerce and Developer APIs it tracks.
 
 </details>
 
@@ -701,7 +701,7 @@ pnpm test && pnpm test:integration         # Vitest unit + integration
 pnpm build                                 # Build to build/
 ```
 
-To run the CI gate locally in Docker before pushing, use [act](https://nektosact.com): `act workflow_dispatch -W .github/workflows/ci.yml`. The root `.actrc` picks the runner image and keeps the pnpm store outside the workspace.
+To run the CI gate locally in Docker before pushing, use [act](https://nektosact.com): `act workflow_dispatch -W .github/workflows/ci.yml`. The machine `~/.actrc` selects the runner, architecture and shared caches.
 
 ## Resources
 

package/build/api/ebaySellerApi.js

@@ -22,7 +22,6 @@ import { FulfillmentApi } from '../api/order-management/fulfillment.js';
 import { LogisticsApi } from '../api/order-management/logistics.js';
 import { EDeliveryApi } from '../api/other/edelivery.js';
 import { BrowseApi } from '../api/other/browse.js';
-import { FindingApi } from '../api/other/finding.js';
 import { IdentityApi } from '../api/other/identity.js';
 import { TranslationApi } from '../api/other/translation.js';
 import { VeroApi } from '../api/other/vero.js';
@@ -60,7 +59,6 @@ export class EbaySellerApi {
     translation;
     edelivery;
     browse;
-    finding;
     developer;
     trading;
     constructor(config) {
@@ -92,7 +90,6 @@ export class EbaySellerApi {
         this.translation = new TranslationApi(this.client);
         this.edelivery = new EDeliveryApi(this.client);
         this.browse = new BrowseApi(this.client);
-        this.finding = new FindingApi(this.client);
         this.developer = new DeveloperApi(this.client);
         const tradingClient = new TradingApiClient(this.client);
         this.trading = new TradingApi(tradingClient);
@@ -170,7 +167,6 @@ export { BrowseApi } from '../api/other/browse.js';
 export { buildBrowseFilter, requireNoPriceFilterConflict } from '../api/other/browseFilter.js';
 export { mapItemDetailsResponse, mapItemSummary, mapSearchActiveItemsResponse, } from '../api/other/browseMappers.js';
 export { BROWSE_SORT_VALUES, } from '../api/other/browseTypes.js';
-export * from '../api/other/finding.js';
 export * from '../api/other/identity.js';
 export * from '../api/other/translation.js';
 export * from '../api/other/vero.js';

package/build/api/other/browse.js

@@ -27,8 +27,7 @@ export class BrowseApi {
      *
      * Uses the Buy Browse API (`item_summary/search`) with the application
      * access token eBay requires for Browse, minted from client credentials
-     * under the basic `api_scope`. The counterpart of `findCompletedItems` for
-     * live listings.
+     * under the basic `api_scope`. Returns live listings only.
      *
      * @param input - Query plus optional pagination, sort, and filters.
      * @returns An Effect that succeeds with cleaned active-listing summaries.

package/build/skills/registrySnapshot.js

@@ -19,7 +19,7 @@ const FAMILY_BLURBS = {
     metadata: 'Marketplace policies, item conditions, listing constraints, automotive compatibility, shipping carriers and services',
     taxonomy: 'Category trees, category suggestions, required item aspects, expired categories, and charities',
     communication: 'Buyer messages, member messages, and notification settings',
-    browse: 'Sold/completed listing search (Finding API) for pricing comps',
+    browse: 'Active listing search and item details (Browse API) for market research',
     other: 'Feedback, recommendations, and assorted Sell-API helpers',
     developer: 'API status, rate limits, client registration, and signing keys',
     trading: 'Legacy Trading API (XML) — create / revise / relist / end fixed-price listings',

package/build/tools/categories/browse.js

@@ -1,16 +1,15 @@
 import { findActiveItemsInputSchema, getItemDetailsInputSchema } from '../../schemas/other/browse.js';
-import { findCompletedItemsInputSchema } from '../../schemas/other/finding.js';
 import { defineTool } from '../../tools/defineTool.js';
 import { Effect } from 'effect';
 /**
- * Browse / Finding tools for public marketplace search data.
+ * Browse tools for public marketplace search data.
  *
  * Gated as family `browse` via `EBAY_MCP_TOOLS=browse`.
  */
 export const browseEntries = [
     defineTool({
         name: 'ebay_find_active_items',
-        description: 'Search active eBay listings marketplace-wide (not the seller\'s own inventory). Uses the Buy Browse API item_summary/search with the application access token eBay requires for Browse, minted from client credentials under the basic api_scope. Supports pagination (limit/offset), sort (price, -price, newlyListed, endingSoonest), category restriction, and condition/buying-option/price filters plus a raw Browse filter passthrough. eBay documents that a search without a buying-option filter returns only listings that still offer FIXED_PRICE, so pass buyingOptions: ["AUCTION"] (or ["AUCTION", "FIXED_PRICE"] for both) to be sure of reaching auctions that have taken a bid. Returns cleaned summaries: itemId (feed into ebay_get_item_details), title, price (an auction\'s current bid when there is no fixed price, with bidCount), condition, buyingOptions, seller and feedback, first advertised shipping cost, auction end date, and listing URL. `hasNext` is the authoritative pagination signal, derived from the `next` link in eBay\'s paged-collection response: page forward by advancing `offset` in whole `limit`-sized steps while `hasNext` is true, and stop as soon as it is false. Neither `total` nor a short page is a pagination signal — `total` is eBay\'s match count for the query and in live testing came back as 0 once `offset` ran past the available result window, and a page can hold fewer items than `limit` without being the last one. The active-listing counterpart of ebay_find_completed_items.',
+        description: 'Search active eBay listings marketplace-wide (not the seller\'s own inventory). Uses the Buy Browse API item_summary/search with the application access token eBay requires for Browse, minted from client credentials under the basic api_scope. Supports pagination (limit/offset), sort (price, -price, newlyListed, endingSoonest), category restriction, and condition/buying-option/price filters plus a raw Browse filter passthrough. eBay documents that a search without a buying-option filter returns only listings that still offer FIXED_PRICE, so pass buyingOptions: ["AUCTION"] (or ["AUCTION", "FIXED_PRICE"] for both) to be sure of reaching auctions that have taken a bid. Returns cleaned summaries: itemId (feed into ebay_get_item_details), title, price (an auction\'s current bid when there is no fixed price, with bidCount), condition, buyingOptions, seller and feedback, first advertised shipping cost, auction end date, and listing URL. `hasNext` is the authoritative pagination signal, derived from the `next` link in eBay\'s paged-collection response: page forward by advancing `offset` in whole `limit`-sized steps while `hasNext` is true, and stop as soon as it is false. Neither `total` nor a short page is a pagination signal — `total` is eBay\'s match count for the query and in live testing came back as 0 once `offset` ran past the available result window, and a page can hold fewer items than `limit` without being the last one.',
         inputSchema: findActiveItemsInputSchema.shape,
         annotations: { readOnlyHint: true },
         handler: (api, args) => Effect.runPromise(api.browse.searchActiveItems(args)),
@@ -22,11 +21,4 @@ export const browseEntries = [
         annotations: { readOnlyHint: true },
         handler: (api, args) => Effect.runPromise(api.browse.getItemDetails(args)),
     }),
-    defineTool({
-        name: 'ebay_find_completed_items',
-        description: 'Search eBay sold/completed listings for pricing research (sold comps). Uses the Finding API findCompletedItems operation with app credentials (SECURITY-APPNAME / EBAY_CLIENT_ID). Returns cleaned sold items: itemId, title, price, shippingCost, soldDate, condition, and listingUrl. Useful for market price research before listing or repricing. App credentials are sufficient for this public search data when OAuth is available.',
-        inputSchema: findCompletedItemsInputSchema.shape,
-        annotations: { readOnlyHint: true },
-        handler: (api, args) => Effect.runPromise(api.finding.findCompletedItems(args)),
-    }),
 ];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ebay-mcp",
-  "version": "2.0.0",
-  "description": "Model Context Protocol (MCP) server that exposes 100% of the eBay Sell, Commerce and Developer APIs it tracks (380 tools across 356 endpoints) to AI assistants like Claude, Cursor, and Cline, covering inventory, order fulfillment, marketing, analytics, and developer tools with OAuth authentication and refresh-token support.",
+  "version": "2.0.2",
+  "description": "Model Context Protocol (MCP) server that exposes 100% of the eBay Sell, Commerce and Developer APIs it tracks (379 tools across 356 endpoints) to AI assistants like Claude, Cursor, and Cline, covering inventory, order fulfillment, marketing, analytics, and developer tools with OAuth authentication and refresh-token support.",
   "type": "module",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -110,9 +110,9 @@
     "skills": "node build/scripts/skills.js",
     "sync": "tsx src/scripts/devSync.ts",
     "diagnose": "node build/scripts/diagnostics.js",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit --incremental --tsBuildInfoFile node_modules/.cache/tsc/src.tsbuildinfo",
     "typecheck:mcp-apps": "tsc -p mcp-apps/tsconfig.json --noEmit",
-    "check": "tsc --noEmit && tsc -p mcp-apps/tsconfig.json --noEmit && biome check \"{src,mcp-apps}/**/*.{ts,tsx,js,json,md,css,html}\"",
+    "check": "pnpm run typecheck && pnpm run typecheck:mcp-apps && biome check \"{src,mcp-apps}/**/*.{ts,tsx,js,json,md,css,html}\"",
     "check:ci": "biome ci .",
     "verify": "pnpm run check:ci && pnpm run typecheck && pnpm run typecheck:mcp-apps && pnpm run test && pnpm run build",
     "fix": "biome check --write --no-errors-on-unmatched --files-ignore-unknown=true \"{src,mcp-apps}/**/*.{ts,tsx,js,json,md,css,html}\"",

package/build/api/other/finding.js

@@ -1,280 +0,0 @@
-import { EbayApiError, EndpointInputError, optionalPositiveNumberEffect, requireObjectEffect, requireStringEffect, } from '../../api/shared/request.js';
-import { isRecord } from '../../utils/typeGuards.js';
-import { Effect } from 'effect';
-/** Finding Service API version used for findCompletedItems. */
-const FINDING_SERVICE_VERSION = '1.13.0';
-/** Default page size when maxResults is omitted. */
-const DEFAULT_MAX_RESULTS = 20;
-/** Hard upper bound for paginationInput.entriesPerPage. */
-const MAX_ENTRIES_PER_PAGE = 100;
-/** Hard upper bound for the EndTimeFrom days-back window. */
-const MAX_DAYS_BACK = 90;
-/**
- * Resolve the Finding Service base URL for the configured environment.
- *
- * Finding lives on the `svcs` host, not the Sell REST `api` host. When a proxy
- * base URL is configured, the Finding path is appended so the proxy can route it.
- *
- * @param environment - eBay environment used when no override is configured.
- * @param overrideBaseUrl - Optional base URL override from `EBAY_MCP_API_BASE_URL`.
- * @returns Absolute Finding Service URL (no trailing slash).
- *
- * @example
- * ```ts
- * const url = getFindingServiceBaseUrl('production');
- * // https://svcs.ebay.com/services/search/FindingService/v1
- * ```
- */
-export const getFindingServiceBaseUrl = (environment, overrideBaseUrl) => {
-    if (overrideBaseUrl) {
-        return `${overrideBaseUrl.replace(/\/$/, '')}/services/search/FindingService/v1`;
-    }
-    return environment === 'production'
-        ? 'https://svcs.ebay.com/services/search/FindingService/v1'
-        : 'https://svcs.sandbox.ebay.com/services/search/FindingService/v1';
-};
-/**
- * Build query parameters for Finding API findCompletedItems.
- *
- * Finding authenticates primarily via `SECURITY-APPNAME` (the app client id).
- * Results are limited to sold listings through the `SoldItemsOnly` item filter.
- *
- * @param input - Validated search input plus the app client id.
- * @returns Wire query params for the Finding Service GET request.
- *
- * @example
- * ```ts
- * const params = buildFindCompletedItemsParams({
- *   keywords: 'iphone 14',
- *   maxResults: 20,
- *   appId: 'client-id',
- * });
- * ```
- */
-export const buildFindCompletedItemsParams = (input) => {
-    const params = {
-        'OPERATION-NAME': 'findCompletedItems',
-        'SERVICE-VERSION': FINDING_SERVICE_VERSION,
-        'SECURITY-APPNAME': input.appId,
-        'RESPONSE-DATA-FORMAT': 'JSON',
-        'REST-PAYLOAD': '',
-        keywords: input.keywords,
-        'paginationInput.entriesPerPage': input.maxResults,
-        'itemFilter(0).name': 'SoldItemsOnly',
-        'itemFilter(0).value': 'true',
-    };
-    if (input.daysBack !== undefined) {
-        const endTimeFrom = new Date();
-        endTimeFrom.setUTCDate(endTimeFrom.getUTCDate() - input.daysBack);
-        params['itemFilter(1).name'] = 'EndTimeFrom';
-        params['itemFilter(1).value'] = endTimeFrom.toISOString();
-    }
-    return params;
-};
-/** Read the first string from a Finding JSON array-or-string field. */
-const firstString = (rawField) => {
-    if (typeof rawField === 'string' && rawField.length > 0) {
-        return rawField;
-    }
-    if (Array.isArray(rawField) && typeof rawField[0] === 'string' && rawField[0].length > 0) {
-        return rawField[0];
-    }
-};
-/** Read the first object from a Finding JSON array-or-object field. */
-const firstRecord = (rawField) => {
-    if (isRecord(rawField)) {
-        return rawField;
-    }
-    if (Array.isArray(rawField) && isRecord(rawField[0])) {
-        return rawField[0];
-    }
-};
-/** Parse a Finding API money field (`@currencyId` + `__value__`). */
-const parseMoney = (rawMoney) => {
-    const money = firstRecord(rawMoney);
-    if (!money) {
-        return;
-    }
-    const currency = typeof money['@currencyId'] === 'string'
-        ? money['@currencyId']
-        : typeof money.currencyId === 'string'
-            ? money.currencyId
-            : undefined;
-    const amount = typeof money.__value__ === 'string'
-        ? money.__value__
-        : typeof money.value === 'string'
-            ? money.value
-            : undefined;
-    if (!(currency && amount)) {
-        return;
-    }
-    return { currency, value: amount };
-};
-/**
- * Map one raw Finding item into a cleaned {@link CompletedItem}.
- *
- * @param raw - One item object from `searchResult.item`.
- * @returns Cleaned item, or undefined when itemId/title are missing.
- */
-export const mapFindingItem = (raw) => {
-    if (!isRecord(raw)) {
-        return;
-    }
-    const itemId = firstString(raw.itemId);
-    const title = firstString(raw.title);
-    if (!(itemId && title)) {
-        return;
-    }
-    const sellingStatus = firstRecord(raw.sellingStatus);
-    const shippingInfo = firstRecord(raw.shippingInfo);
-    const listingInfo = firstRecord(raw.listingInfo);
-    const condition = firstRecord(raw.condition);
-    const price = parseMoney(sellingStatus?.currentPrice);
-    const shippingCost = parseMoney(shippingInfo?.shippingServiceCost);
-    const soldDate = firstString(listingInfo?.endTime);
-    const conditionName = firstString(condition?.conditionDisplayName);
-    const listingUrl = firstString(raw.viewItemURL);
-    return {
-        itemId,
-        title,
-        ...(price === undefined ? {} : { price }),
-        ...(shippingCost === undefined ? {} : { shippingCost }),
-        ...(soldDate === undefined ? {} : { soldDate }),
-        ...(conditionName === undefined ? {} : { condition: conditionName }),
-        ...(listingUrl === undefined ? {} : { listingUrl }),
-    };
-};
-/**
- * Map a raw Finding findCompletedItems JSON response into cleaned sold comps.
- *
- * Finding wraps most nodes in single-element arrays (XML→JSON conversion).
- *
- * @param raw - Full JSON body returned by the Finding Service.
- * @param keywords - Keywords used for the request (echoed in the result).
- * @returns Cleaned items plus optional total entry count.
- *
- * @example
- * ```ts
- * const soldListings = mapFindCompletedItemsResponse(rawJson, 'iphone 14');
- * ```
- */
-export const mapFindCompletedItemsResponse = (raw, keywords) => {
-    if (!isRecord(raw)) {
-        return { items: [], keywords };
-    }
-    const responseRoot = firstRecord(raw.findCompletedItemsResponse);
-    if (!responseRoot) {
-        return { items: [], keywords };
-    }
-    const searchResult = firstRecord(responseRoot.searchResult);
-    const rawItems = searchResult?.item;
-    const itemList = Array.isArray(rawItems) ? rawItems : rawItems === undefined ? [] : [rawItems];
-    const items = [];
-    for (const entry of itemList) {
-        const mapped = mapFindingItem(entry);
-        if (mapped) {
-            items.push(mapped);
-        }
-    }
-    const pagination = firstRecord(responseRoot.paginationOutput);
-    const totalRaw = firstString(pagination?.totalEntries);
-    const totalEntries = totalRaw !== undefined && Number.isFinite(Number(totalRaw)) ? Number(totalRaw) : undefined;
-    return {
-        items,
-        keywords,
-        ...(totalEntries === undefined ? {} : { totalEntries }),
-    };
-};
-/**
- * Validate maxResults falls within Finding's supported range.
- *
- * @param maxResults - Positive page size already validated as > 0.
- * @returns The same value when in range, or a tagged input error.
- */
-const requireMaxResultsInRange = (maxResults) => {
-    if (maxResults > MAX_ENTRIES_PER_PAGE) {
-        return Effect.fail(new EndpointInputError({
-            parameter: 'maxResults',
-            message: `maxResults must be between 1 and ${MAX_ENTRIES_PER_PAGE}`,
-        }));
-    }
-    return Effect.succeed(maxResults);
-};
-/**
- * Validate daysBack falls within the supported window when provided.
- *
- * @param daysBack - Optional positive day count.
- * @returns The same value (or undefined) when valid, or a tagged input error.
- */
-const requireDaysBackInRange = (daysBack) => {
-    if (daysBack === undefined) {
-        return Effect.succeed(undefined);
-    }
-    if (daysBack > MAX_DAYS_BACK) {
-        return Effect.fail(new EndpointInputError({
-            parameter: 'daysBack',
-            message: `daysBack must be between 1 and ${MAX_DAYS_BACK}`,
-        }));
-    }
-    return Effect.succeed(daysBack);
-};
-/** Finding API - sold/completed listing search for pricing research. */
-export class FindingApi {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    /**
-     * Search sold and completed eBay listings for pricing comps.
-     *
-     * Uses the legacy Finding API (`findCompletedItems`) with app credentials
-     * (`SECURITY-APPNAME`). Useful for market price research; sold listings only.
-     *
-     * @param input - Keywords plus optional result cap and days-back window.
-     * @returns An Effect that succeeds with cleaned sold-item comps.
-     *
-     * @example
-     * ```ts
-     * const comps = await Effect.runPromise(
-     *   findingApi.findCompletedItems({ keywords: 'nike dunk low', maxResults: 25, daysBack: 30 }),
-     * );
-     * ```
-     *
-     * @see https://developer.ebay.com/devzone/finding/callref/findCompletedItems.html
-     */
-    findCompletedItems = (input) => {
-        const client = this.client;
-        return Effect.gen(function* () {
-            const validatedInput = yield* requireObjectEffect(input, 'input');
-            const keywords = yield* requireStringEffect(validatedInput.keywords, 'keywords');
-            const maxResultsRaw = yield* optionalPositiveNumberEffect(validatedInput.maxResults, 'maxResults');
-            const daysBackRaw = yield* optionalPositiveNumberEffect(validatedInput.daysBack, 'daysBack');
-            const maxResults = yield* requireMaxResultsInRange(maxResultsRaw ?? DEFAULT_MAX_RESULTS);
-            const daysBack = yield* requireDaysBackInRange(daysBackRaw);
-            const config = client.getConfig();
-            const appId = config.clientId;
-            if (!appId) {
-                return yield* Effect.fail(new EndpointInputError({
-                    parameter: 'clientId',
-                    message: 'EBAY_CLIENT_ID is required for Finding API requests (SECURITY-APPNAME). Set it in your environment.',
-                }));
-            }
-            const baseUrl = getFindingServiceBaseUrl(config.environment, config.apiBaseUrl);
-            const params = buildFindCompletedItemsParams({
-                keywords,
-                maxResults,
-                ...(daysBack === undefined ? {} : { daysBack }),
-                appId,
-            });
-            const raw = yield* Effect.tryPromise({
-                try: () => client.getWithFullUrl(baseUrl, params),
-                catch: (cause) => new EbayApiError({
-                    method: 'GET',
-                    path: baseUrl,
-                    cause,
-                }),
-            });
-            return mapFindCompletedItemsResponse(raw, keywords);
-        });
-    };
-}

package/build/schemas/other/finding.js

@@ -1,27 +0,0 @@
-import { z } from 'zod';
-/**
- * Finding API Schemas
- *
- * Zod input schemas for sold/completed listing search tools.
- */
-/**
- * Validates input for ebay_find_completed_items (Finding API findCompletedItems).
- */
-export const findCompletedItemsInputSchema = z.object({
-    keywords: z
-        .string()
-        .min(1)
-        .describe('Search keywords for sold/completed listings (e.g. "iphone 14 pro 256")'),
-    maxResults: z
-        .number()
-        .int()
-        .positive()
-        .optional()
-        .describe('Maximum sold items to return (1–100). Defaults to 20.'),
-    daysBack: z
-        .number()
-        .int()
-        .positive()
-        .optional()
-        .describe('Only include items that ended within this many days (1–90).'),
-});