ebay-mcp 1.4.3

package/build/api/listing-metadata/taxonomy.js

@@ -0,0 +1,58 @@
+/**
+ * Taxonomy API - Category trees and hierarchies
+ * Based on: eBay Commerce Taxonomy API
+ */
+export class TaxonomyApi {
+    client;
+    basePath = '/commerce/taxonomy/v1';
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Get the default category tree ID for a marketplace
+     */
+    async getDefaultCategoryTreeId(marketplaceId) {
+        return await this.client.get(`${this.basePath}/get_default_category_tree_id`, {
+            marketplace_id: marketplaceId,
+        });
+    }
+    /**
+     * Get category tree
+     */
+    async getCategoryTree(categoryTreeId) {
+        return await this.client.get(`${this.basePath}/category_tree/${categoryTreeId}`);
+    }
+    /**
+     * Get category subtree
+     */
+    async getCategorySubtree(categoryTreeId, categoryId) {
+        return await this.client.get(`${this.basePath}/category_tree/${categoryTreeId}/get_category_subtree`, { category_id: categoryId });
+    }
+    /**
+     * Get category suggestions
+     */
+    async getCategorySuggestions(categoryTreeId, query) {
+        return await this.client.get(`${this.basePath}/category_tree/${categoryTreeId}/get_category_suggestions`, { q: query });
+    }
+    /**
+     * Get item aspects for category
+     */
+    async getItemAspectsForCategory(categoryTreeId, categoryId) {
+        return await this.client.get(`${this.basePath}/category_tree/${categoryTreeId}/get_item_aspects_for_category`, { category_id: categoryId });
+    }
+    /**
+     * Get compatibility properties
+     */
+    async getCompatibilityProperties(categoryTreeId, categoryId) {
+        return await this.client.get(`${this.basePath}/category_tree/${categoryTreeId}/get_compatibility_properties`, { category_id: categoryId });
+    }
+    /**
+     * Get compatibility property values
+     */
+    async getCompatibilityPropertyValues(categoryTreeId, categoryId, compatibilityProperty) {
+        return await this.client.get(`${this.basePath}/category_tree/${categoryTreeId}/get_compatibility_property_values`, {
+            category_id: categoryId,
+            compatibility_property: compatibilityProperty,
+        });
+    }
+}

package/build/api/marketing-and-promotions/marketing.d.ts

@@ -0,0 +1,395 @@
+import type { EbayApiClient } from '../../api/client.js';
+import type { components } from '../../types/sell-apps/markeitng-and-promotions/sellMarketingV1Oas3.js';
+type AdGroupRequest = components['schemas']['CreateAdGroupRequest'];
+type BulkCreateAdRequest = components['schemas']['BulkCreateAdRequest'];
+type BulkCreateAdsByInventoryReferenceRequest = components['schemas']['BulkCreateAdsByInventoryReferenceRequest'];
+type BulkCreateKeywordsRequest = components['schemas']['BulkCreateKeywordRequest'];
+type BulkDeleteAdRequest = components['schemas']['BulkDeleteAdRequest'];
+type BulkDeleteKeywordsRequest = components['schemas']['BulkDeleteAdRequest'];
+type BulkUpdateAdStatusByListingIdRequest = components['schemas']['BulkUpdateAdStatusByListingIdRequest'];
+type BulkUpdateAdStatusRequest = components['schemas']['BulkUpdateAdStatusRequest'];
+type BulkUpdateKeywordBidsRequest = components['schemas']['BulkUpdateKeywordRequest'];
+type CloneCampaignRequest = components['schemas']['CloneCampaignRequest'];
+type CreateAdRequest = components['schemas']['CreateAdRequest'];
+type CreateAdsByInventoryReferenceRequest = components['schemas']['CreateAdsByInventoryReferenceRequest'];
+type CreateCampaignRequest = components['schemas']['CreateCampaignRequest'];
+type CreateKeywordRequest = components['schemas']['CreateKeywordRequest'];
+type CreateNegativeKeywordRequest = components['schemas']['CreateNegativeKeywordRequest'];
+type CreateReportTask = components['schemas']['CreateReportTask'];
+type ItemPromotion = components['schemas']['ItemPromotion'];
+type UpdateBidPercentageRequest = components['schemas']['UpdateBidPercentageRequest'];
+type UpdateCampaignIdentificationRequest = components['schemas']['UpdateCampaignIdentificationRequest'];
+type Ad = components['schemas']['Ad'];
+type AdGroup = components['schemas']['AdGroup'];
+type AdGroupPagedCollection = components['schemas']['AdGroupPagedCollectionResponse'];
+type AdPagedCollectionResponse = components['schemas']['AdPagedCollectionResponse'];
+type AdReferences = components['schemas']['AdReferences'];
+type Ads = components['schemas']['Ads'];
+type BaseResponse = components['schemas']['BaseResponse'];
+type BulkAdResponse = components['schemas']['BulkAdResponse'];
+type BulkAdUpdateResponse = components['schemas']['BulkAdUpdateResponse'];
+type BulkAdUpdateStatusByListingIdResponse = components['schemas']['BulkAdUpdateStatusByListingIdResponse'];
+type BulkAdUpdateStatusResponse = components['schemas']['BulkAdUpdateStatusResponse'];
+type BulkCreateAdsByInventoryReferenceResponse = components['schemas']['BulkCreateAdsByInventoryReferenceResponse'];
+type BulkCreateKeywordsResponse = components['schemas']['BulkCreateKeywordResponse'];
+type BulkDeleteAdResponse = components['schemas']['BulkDeleteAdResponse'];
+type BulkDeleteAdsByInventoryReferenceResponse = components['schemas']['BulkDeleteAdsByInventoryReferenceResponse'];
+type BulkUpdateAdsByInventoryReferenceResponse = components['schemas']['BulkUpdateAdsByInventoryReferenceResponse'];
+type BulkUpdateKeywordBidsResponse = components['schemas']['BulkUpdateKeywordResponse'];
+type Campaign = components['schemas']['Campaign'];
+type CampaignPagedCollectionResponse = components['schemas']['CampaignPagedCollectionResponse'];
+type Keyword = components['schemas']['Keyword'];
+type KeywordPagedCollection = components['schemas']['KeywordPagedCollectionResponse'];
+type NegativeKeyword = components['schemas']['NegativeKeyword'];
+type NegativeKeywordPagedCollection = components['schemas']['NegativeKeywordPagedCollectionResponse'];
+type PromotionsReportPagedCollection = components['schemas']['PromotionsReportPagedCollection'];
+type ReportMetadata = components['schemas']['ReportMetadata'];
+type ReportMetadatas = components['schemas']['ReportMetadatas'];
+type ReportTask = components['schemas']['ReportTask'];
+type ReportTaskPagedCollection = components['schemas']['ReportTaskPagedCollection'];
+type SuggestedBids = components['schemas']['SuggestedBids'];
+type SuggestedKeywords = components['schemas']['SuggestedKeywords'];
+type SummaryReportResponse = components['schemas']['SummaryReportResponse'];
+type BulkCreateNegativeKeywordRequest = components['schemas']['BulkCreateNegativeKeywordRequest'];
+type BulkCreateNegativeKeywordResponse = components['schemas']['BulkCreateNegativeKeywordResponse'];
+type BulkUpdateNegativeKeywordRequest = components['schemas']['BulkUpdateNegativeKeywordRequest'];
+type BulkUpdateNegativeKeywordResponse = components['schemas']['BulkUpdateNegativeKeywordResponse'];
+type NegativeKeywordRequest = components['schemas']['UpdateNegativeKeywordRequest'];
+type BulkDeleteAdsByInventoryReferenceRequest = Record<string, unknown>;
+type CreateAdGroupRequest = AdGroupRequest;
+type UpdateKeywordByKeywordIdRequest = Record<string, unknown>;
+type SuggestKeywordsRequest = Record<string, unknown>;
+type UpdateBidRequest = Record<string, unknown>;
+type ItemPromotionRequest = Record<string, unknown>;
+type ItemPromotionResponse = Record<string, unknown>;
+type ItemPromotionsPagedCollection = Record<string, unknown>;
+type TargetingRequest = Record<string, unknown>;
+type TargetingResponse = Record<string, unknown>;
+type BulkDeleteKeywordsResponse = Record<string, unknown>;
+type CreateKeywordResponse = Record<string, unknown>;
+type BulkDeleteNegativeKeywordRequest = Record<string, unknown>;
+type BulkDeleteNegativeKeywordResponse = Record<string, unknown>;
+type Report = Record<string, unknown>;
+type BulkUpdateKeywordRequest = BulkUpdateKeywordBidsRequest;
+/**
+ * Marketing API - Marketing campaigns and promotions
+ * Based on: docs/sell-apps/marketing-and-promotions/sell_marketing_v1_oas3.json
+ */
+export declare class MarketingApi {
+    private client;
+    private readonly basePath;
+    constructor(client: EbayApiClient);
+    /**
+     * Get campaigns
+     */
+    getCampaigns(campaignStatus?: string, marketplaceId?: string, limit?: number): Promise<CampaignPagedCollectionResponse>;
+    /**
+     * Get a specific campaign
+     */
+    getCampaign(campaignId: string): Promise<Campaign>;
+    /**
+     * Create a campaign
+     */
+    createCampaign(campaign: CreateCampaignRequest): Promise<BaseResponse>;
+    /**
+     * Get promotions
+     */
+    getPromotions(marketplaceId?: string, limit?: number): Promise<ItemPromotionsPagedCollection>;
+    /**
+     * Create a promotion (item promotion)
+     */
+    createPromotion(promotion: ItemPromotion): Promise<BaseResponse>;
+    /**
+     * Get ads for a campaign
+     */
+    getAds(campaignId: string, adGroupIds?: string, adStatus?: string, limit?: number, listingIds?: string, offset?: number): Promise<AdPagedCollectionResponse>;
+    /**
+     * Create an ad for a campaign
+     */
+    createAd(campaignId: string, ad: CreateAdRequest): Promise<BaseResponse>;
+    /**
+     * Create ads by inventory reference for a campaign
+     */
+    createAdsByInventoryReference(campaignId: string, ads: CreateAdsByInventoryReferenceRequest): Promise<AdReferences>;
+    /**
+     * Get a specific ad for a campaign
+     */
+    getAd(campaignId: string, adId: string): Promise<Ad>;
+    /**
+     * Delete a specific ad from a campaign
+     */
+    deleteAd(campaignId: string, adId: string): Promise<void>;
+    /**
+     * Clone an ad for a campaign
+     */
+    cloneAd(campaignId: string, adId: string, ad: CreateAdRequest): Promise<BaseResponse>;
+    /**
+     * Get ads by inventory reference for a campaign
+     */
+    getAdsByInventoryReference(campaignId: string, inventoryReferenceId: string, inventoryReferenceType: string): Promise<Ads>;
+    /**
+     * Get ads by listing ID for a campaign
+     */
+    getAdsByListingId(campaignId: string, listingId: string): Promise<Ads>;
+    /**
+     * Update the bid for an ad in a campaign
+     */
+    updateBid(campaignId: string, adId: string, bid: UpdateBidPercentageRequest): Promise<void>;
+    /**
+     * Clone a campaign
+     */
+    cloneCampaign(campaignId: string, campaign: CloneCampaignRequest): Promise<BaseResponse>;
+    /**
+     * End a campaign
+     */
+    endCampaign(campaignId: string): Promise<void>;
+    /**
+     * Get campaign by name
+     */
+    getCampaignByName(campaignName: string): Promise<Campaign>;
+    /**
+     * Bulk create ads by inventory reference
+     */
+    bulkCreateAdsByInventoryReference(campaignId: string, body: BulkCreateAdsByInventoryReferenceRequest): Promise<BulkCreateAdsByInventoryReferenceResponse>;
+    /**
+     * Bulk create ads by listing id
+     */
+    bulkCreateAdsByListingId(campaignId: string, body: BulkCreateAdRequest): Promise<BulkAdResponse>;
+    /**
+     * Bulk delete ads by inventory reference
+     */
+    bulkDeleteAdsByInventoryReference(campaignId: string, body: BulkDeleteAdsByInventoryReferenceRequest): Promise<BulkDeleteAdsByInventoryReferenceResponse>;
+    /**
+     * Bulk delete ads by listing id
+     */
+    bulkDeleteAdsByListingId(campaignId: string, body: BulkDeleteAdRequest): Promise<BulkDeleteAdResponse>;
+    /**
+     * Bulk update ads bid by inventory reference
+     */
+    bulkUpdateAdsBidByInventoryReference(campaignId: string, body: BulkCreateAdsByInventoryReferenceRequest): Promise<BulkUpdateAdsByInventoryReferenceResponse>;
+    /**
+     * Bulk update ads bid by listing id
+     */
+    bulkUpdateAdsBidByListingId(campaignId: string, body: BulkCreateAdRequest): Promise<BulkAdUpdateResponse>;
+    /**
+     * Bulk update ads status
+     */
+    bulkUpdateAdsStatus(campaignId: string, body: BulkUpdateAdStatusRequest): Promise<BulkAdUpdateStatusResponse>;
+    /**
+     * Bulk update ads status by listing id
+     */
+    bulkUpdateAdsStatusByListingId(campaignId: string, body: BulkUpdateAdStatusByListingIdRequest): Promise<BulkAdUpdateStatusByListingIdResponse>;
+    /**
+     * Pause a campaign
+     */
+    pauseCampaign(campaignId: string): Promise<void>;
+    /**
+     * Resume a campaign
+     */
+    resumeCampaign(campaignId: string): Promise<void>;
+    /**
+     * Update campaign identification
+     */
+    updateCampaignIdentification(campaignId: string, body: UpdateCampaignIdentificationRequest): Promise<void>;
+    /**
+     * Create an ad group
+     */
+    createAdGroup(campaignId: string, body: AdGroupRequest): Promise<BaseResponse>;
+    /**
+     * Clone an ad group
+     */
+    cloneAdGroup(campaignId: string, adGroupId: string, body: CreateAdGroupRequest): Promise<BaseResponse>;
+    /**
+     * Get ad groups
+     */
+    getAdGroups(campaignId: string, adGroupStatus?: string, limit?: number, offset?: number): Promise<AdGroupPagedCollection>;
+    /**
+     * Get an ad group
+     */
+    getAdGroup(campaignId: string, adGroupId: string): Promise<AdGroup>;
+    /**
+     * Suggest bids for an ad group
+     */
+    suggestBids(campaignId: string, adGroupId: string): Promise<SuggestedBids>;
+    /**
+     * Update ad group bids
+     */
+    updateAdGroupBids(campaignId: string, adGroupId: string, body: UpdateKeywordByKeywordIdRequest): Promise<void>;
+    /**
+     * Update ad group keywords
+     */
+    updateAdGroupKeywords(campaignId: string, adGroupId: string, body: BulkUpdateKeywordRequest): Promise<void>;
+    /**
+     * Suggest keywords
+     */
+    suggestKeywords(campaignId: string, adGroupId: string, body: SuggestKeywordsRequest): Promise<SuggestedKeywords>;
+    /**
+     * Get keywords
+     */
+    getKeywords(campaignId: string, adGroupId: string, keywordStatus?: string, limit?: number, offset?: number): Promise<KeywordPagedCollection>;
+    /**
+     * Bulk create keywords
+     */
+    bulkCreateKeywords(campaignId: string, adGroupId: string, body: BulkCreateKeywordsRequest): Promise<BulkCreateKeywordsResponse>;
+    /**
+     * Bulk delete keywords
+     */
+    bulkDeleteKeywords(campaignId: string, adGroupId: string, body: BulkDeleteKeywordsRequest): Promise<BulkDeleteKeywordsResponse>;
+    /**
+     * Bulk update keyword bids
+     */
+    bulkUpdateKeywordBids(campaignId: string, adGroupId: string, body: BulkUpdateKeywordBidsRequest): Promise<BulkUpdateKeywordBidsResponse>;
+    /**
+     * Create a keyword
+     */
+    createKeyword(campaignId: string, adGroupId: string, body: CreateKeywordRequest): Promise<CreateKeywordResponse>;
+    /**
+     * Get a keyword
+     */
+    getKeyword(campaignId: string, adGroupId: string, keywordId: string): Promise<Keyword>;
+    /**
+     * Delete a keyword
+     */
+    deleteKeyword(campaignId: string, adGroupId: string, keywordId: string): Promise<void>;
+    /**
+     * Update a keyword's bid
+     */
+    updateKeywordBid(campaignId: string, adGroupId: string, keywordId: string, body: UpdateBidRequest): Promise<void>;
+    /**
+     * Get ad report
+     */
+    getAdReport(dimension: string, metric: string, startDate: string, endDate: string, sort?: string, listingIds?: string, marketplaceId?: string): Promise<Report>;
+    /**
+     * Get ad report metadata
+     */
+    getAdReportMetadata(): Promise<ReportMetadatas>;
+    /**
+     * Get ad report metadata for a report type
+     */
+    getAdReportMetadataForReportType(reportType: string): Promise<ReportMetadata>;
+    /**
+     * Create a report task
+     */
+    createReportTask(body: CreateReportTask): Promise<void>;
+    /**
+     * Get report tasks
+     */
+    getReportTasks(reportTaskStatuses?: string, limit?: number, offset?: number): Promise<ReportTaskPagedCollection>;
+    /**
+     * Get a report task
+     */
+    getReportTask(reportTaskId: string): Promise<ReportTask>;
+    /**
+     * Get an item promotion
+     */
+    getItemPromotion(promotionId: string): Promise<ItemPromotionResponse>;
+    /**
+     * Delete an item promotion
+     */
+    deleteItemPromotion(promotionId: string): Promise<void>;
+    /**
+     * Pause an item promotion
+     */
+    pauseItemPromotion(promotionId: string): Promise<void>;
+    /**
+     * Resume an item promotion
+     */
+    resumeItemPromotion(promotionId: string): Promise<void>;
+    /**
+     * Update an item promotion
+     */
+    updateItemPromotion(promotionId: string, body: ItemPromotionRequest): Promise<BaseResponse>;
+    /**
+     * Get a promotion report
+     */
+    getPromotionReport(marketplaceId: string, promotionStatus?: string, limit?: number, offset?: number): Promise<PromotionsReportPagedCollection>;
+    /**
+     * Get a promotion summary report
+     */
+    getPromotionSummaryReport(marketplaceId: string): Promise<SummaryReportResponse>;
+    /**
+     * Get promotion summary (alias for getPromotionSummaryReport)
+     */
+    getPromotionSummary(marketplaceId: string): Promise<SummaryReportResponse>;
+    /**
+     * Get promotion reports (alias for getPromotionReport)
+     */
+    getPromotionReports(marketplaceId: string, promotionStatus?: string, limit?: number, offset?: number): Promise<PromotionsReportPagedCollection>;
+    /**
+     * Get targeting for a campaign
+     */
+    getTargeting(campaignId: string): Promise<TargetingResponse>;
+    /**
+     * Create targeting for a campaign
+     */
+    createTargeting(campaignId: string, body: TargetingRequest): Promise<void>;
+    /**
+     * Update targeting for a campaign
+     */
+    updateTargeting(campaignId: string, body: TargetingRequest): Promise<void>;
+    /**
+     * Get negative keywords for a campaign
+     */
+    getNegativeKeywords(campaignId: string, limit?: number, offset?: number): Promise<NegativeKeywordPagedCollection>;
+    /**
+     * Create a negative keyword for a campaign
+     */
+    createNegativeKeyword(campaignId: string, body: CreateNegativeKeywordRequest): Promise<BaseResponse>;
+    /**
+     * Bulk create negative keywords for a campaign
+     */
+    bulkCreateNegativeKeywords(campaignId: string, body: BulkCreateNegativeKeywordRequest): Promise<BulkCreateNegativeKeywordResponse>;
+    /**
+     * Bulk delete negative keywords for a campaign
+     */
+    bulkDeleteNegativeKeywords(campaignId: string, body: BulkDeleteNegativeKeywordRequest): Promise<BulkDeleteNegativeKeywordResponse>;
+    /**
+     * Bulk update negative keywords for a campaign
+     */
+    bulkUpdateNegativeKeywords(campaignId: string, body: BulkUpdateNegativeKeywordRequest): Promise<BulkUpdateNegativeKeywordResponse>;
+    /**
+     * Get a negative keyword for a campaign
+     */
+    getNegativeKeyword(campaignId: string, negativeKeywordId: string): Promise<NegativeKeyword>;
+    /**
+     * Delete a negative keyword for a campaign
+     */
+    deleteNegativeKeyword(campaignId: string, negativeKeywordId: string): Promise<void>;
+    /**
+     * Update a negative keyword for a campaign
+     */
+    updateNegativeKeyword(campaignId: string, negativeKeywordId: string, body: NegativeKeywordRequest): Promise<BaseResponse>;
+    /**
+     * Get negative keywords for an ad group
+     */
+    getNegativeKeywordsForAdGroup(adGroupId: string, limit?: number, offset?: number): Promise<NegativeKeywordPagedCollection>;
+    /**
+     * Create a negative keyword for an ad group
+     */
+    createNegativeKeywordForAdGroup(adGroupId: string, body: CreateNegativeKeywordRequest): Promise<BaseResponse>;
+    /**
+     * Bulk create negative keywords for an ad group
+     */
+    bulkCreateNegativeKeywordsForAdGroup(adGroupId: string, body: BulkCreateNegativeKeywordRequest): Promise<BulkCreateNegativeKeywordResponse>;
+    /**
+     * Bulk delete negative keywords for an ad group
+     */
+    bulkDeleteNegativeKeywordsForAdGroup(adGroupId: string, body: BulkDeleteNegativeKeywordRequest): Promise<BulkDeleteNegativeKeywordResponse>;
+    /**
+     * Bulk update negative keywords for an ad group
+     */
+    bulkUpdateNegativeKeywordsForAdGroup(adGroupId: string, body: BulkUpdateNegativeKeywordRequest): Promise<BulkUpdateNegativeKeywordResponse>;
+    /**
+     * Get a negative keyword for an ad group
+     */
+    getNegativeKeywordForAdGroup(adGroupId: string, negativeKeywordId: string): Promise<NegativeKeyword>;
+    /**
+     * Delete a negative keyword for an ad group
+     */
+    deleteNegativeKeywordForAdGroup(adGroupId: string, negativeKeywordId: string): Promise<void>;
+    /**
+     * Update a negative keyword for an ad group
+     */
+    updateNegativeKeywordForAdGroup(adGroupId: string, negativeKeywordId: string, body: NegativeKeywordRequest): Promise<BaseResponse>;
+}
+export {};