yandex-direct-mcp-plus 1.4.0 → 1.5.0

package/dist/app/registry.js

@@ -11,7 +11,7 @@ import { getChangesTool } from "#tools/changes/tool";
 import { getRegionsTool, listTimeZonesTool } from "#tools/dictionaries/tool";
 import { listDynamicTargetsTool, manageDynamicTargetsTool } from "#tools/dynamic-targets/tool";
 import { listFeedsTool } from "#tools/feeds/tool";
-import { addKeywordsTool, listKeywordsTool, manageKeywordsTool, setKeywordBidsTool, updateKeywordsTool } from "#tools/keywords/tool";
+import { addKeywordsTool, getKeywordAuctionTool, listKeywordsTool, manageKeywordsTool, setKeywordBidsTool, updateKeywordsTool } from "#tools/keywords/tool";
 import { getCampaignNegativeKeywordsTool, linkNegativeKeywordSetsTool, listNegativeKeywordSharedSetsTool, manageNegativeKeywordSharedSetsTool, setAdGroupNegativeKeywordsTool, setCampaignNegativeKeywordsTool } from "#tools/negative-keywords/tool";
 import { addRetargetingListTool, deleteRetargetingListsTool, listRetargetingListsTool, updateRetargetingListsTool } from "#tools/retargeting/tool";
 import { getSearchQueriesTool } from "#tools/search-queries/tool";
@@ -46,6 +46,7 @@ export const tools = [
     updateKeywordsTool,
     manageKeywordsTool,
     setKeywordBidsTool,
+    getKeywordAuctionTool,
     // Минус-фразы
     getCampaignNegativeKeywordsTool,
     setCampaignNegativeKeywordsTool,

package/dist/shared/config/api-fields.d.ts

@@ -0,0 +1,161 @@
+export declare const API_FIELDS: {
+    readonly adextensions: {
+        readonly AdExtensionFieldEnum: readonly ["Associated", "Id", "State", "Status", "StatusClarification", "Type"];
+        readonly CalloutFieldEnum: readonly ["CalloutText"];
+    };
+    readonly adgroups: {
+        readonly AdGroupFieldEnum: readonly ["CampaignId", "Id", "Name", "NegativeKeywordSharedSetIds", "NegativeKeywords", "RegionIds", "RestrictedRegionIds", "ServingStatus", "Status", "Subtype", "TrackingParams", "Type"];
+        readonly DynamicTextAdGroupFieldEnum: readonly ["AutotargetingCategories", "AutotargetingSettings", "DomainUrl", "DomainUrlProcessingStatus"];
+        readonly DynamicTextFeedAdGroupFieldEnum: readonly ["AutotargetingCategories", "AutotargetingSettings", "FeedId", "Source", "SourceProcessingStatus", "SourceType"];
+        readonly MobileAppAdGroupFieldEnum: readonly ["AppAvailabilityStatus", "AppIconModeration", "AppOperatingSystemType", "StoreUrl", "TargetCarrier", "TargetDeviceType", "TargetOperatingSystemVersion"];
+        readonly SmartAdGroupFieldEnum: readonly ["AdBodySource", "AdTitleSource", "FeedId"];
+        readonly TextAdGroupFeedParamsFieldEnum: readonly ["FeedCategoryIds", "FeedId"];
+        readonly UnifiedAdGroupFieldEnum: readonly ["OfferRetargeting"];
+    };
+    readonly adimages: {
+        readonly AdImageFieldEnum: readonly ["AdImageHash", "Associated", "Name", "OriginalUrl", "PreviewUrl", "Subtype", "Type"];
+    };
+    readonly ads: {
+        readonly AdFieldEnum: readonly ["AdCategories", "AdGroupId", "AgeLabel", "CampaignId", "Id", "State", "Status", "StatusClarification", "Subtype", "Type"];
+        readonly CpcVideoAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "Href", "TurboPageId", "TurboPageModeration"];
+        readonly CpmBannerAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "Href", "TrackingPixels", "TurboPageId", "TurboPageModeration"];
+        readonly CpmVideoAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "Href", "TrackingPixels", "TurboPageId", "TurboPageModeration"];
+        readonly DynamicTextAdFieldEnum: readonly ["AdExtensions", "AdImageHash", "AdImageModeration", "SitelinkSetId", "SitelinksModeration", "Text", "VCardId", "VCardModeration"];
+        readonly ListingAdFieldEnum: readonly ["AdExtensions", "BusinessId", "DefaultTexts", "FeedFilterConditions", "FeedId", "FeedProcessingStatus", "SitelinkSetId", "SitelinksModeration", "TextSources", "TitleSources"];
+        readonly MobileAppAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "TrackingUrl"];
+        readonly MobileAppAdFieldEnum: readonly ["Action", "AdImageHash", "AdImageModeration", "AutogeneratedErirAdDescription", "ErirAdDescription", "Features", "Text", "Title", "TrackingUrl", "VideoExtension"];
+        readonly MobileAppCpcVideoAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "TrackingUrl"];
+        readonly MobileAppImageAdFieldEnum: readonly ["AdImageHash", "AutogeneratedErirAdDescription", "ErirAdDescription", "TrackingUrl"];
+        readonly ResponsiveAdFieldEnum: readonly ["AdExtensions", "AdImages", "BusinessId", "DisplayDomain", "DisplayUrlPath", "DisplayUrlPathModeration", "ErirAdDescription", "Href", "PriceExtension", "SitelinkSetId", "SitelinksModeration", "Texts", "Titles", "VideoExtensions"];
+        readonly ShoppingAdFieldEnum: readonly ["AdExtensions", "BusinessId", "DefaultTexts", "FeedFilterConditions", "FeedId", "FeedProcessingStatus", "SitelinkSetId", "SitelinksModeration", "TextSources", "TitleSources"];
+        readonly SmartAdBuilderAdFieldEnum: readonly ["Creative"];
+        readonly TextAdBuilderAdFieldEnum: readonly ["AutogeneratedErirAdDescription", "Creative", "ErirAdDescription", "FinalUrl", "Href", "TurboPageId", "TurboPageModeration"];
+        readonly TextAdFieldEnum: readonly ["AdExtensions", "AdImageHash", "AdImageModeration", "AutogeneratedErirAdDescription", "BusinessId", "DisplayDomain", "DisplayUrlPath", "DisplayUrlPathModeration", "ErirAdDescription", "FinalUrl", "Href", "Mobile", "PreferVCardOverBusiness", "SitelinkSetId", "SitelinksModeration", "Text", "Title", "Title2", "TurboPageId", "TurboPageModeration", "VCardId", "VCardModeration", "VideoExtension"];
+        readonly TextAdPriceExtensionFieldEnum: readonly ["OldPrice", "Price", "PriceCurrency", "PriceQualifier"];
+        readonly TextImageAdFieldEnum: readonly ["AdImageHash", "AutogeneratedErirAdDescription", "ErirAdDescription", "FinalUrl", "Href", "TurboPageId", "TurboPageModeration"];
+    };
+    readonly agencyclients: {
+        readonly AgencyClientFieldEnum: readonly ["AccountQuality", "Archived", "AvailableAdGroupTypes", "AvailableCampaignTypes", "Bonuses", "ClientId", "ClientInfo", "CountryId", "CreatedAt", "Currency", "ForbiddenPlatform", "Grants", "Login", "Notification", "OverdraftSumAvailable", "Phone", "Representatives", "Restrictions", "Settings", "Type", "VatRate"];
+    };
+    readonly audiencetargets: {
+        readonly AudienceTargetFieldEnum: readonly ["AdGroupId", "CampaignId", "ContextBid", "Id", "InterestId", "RetargetingListId", "State", "StrategyPriority"];
+    };
+    readonly bidmodifiers: {
+        readonly AdGroupAdjustmentFieldEnum: readonly ["BidModifier"];
+        readonly BidModifierFieldEnum: readonly ["AdGroupId", "CampaignId", "Id", "Level", "Type"];
+        readonly DemographicsAdjustmentFieldEnum: readonly ["Age", "BidModifier", "Enabled", "Gender"];
+        readonly DesktopAdjustmentFieldEnum: readonly ["BidModifier"];
+        readonly DesktopOnlyAdjustmentFieldEnum: readonly ["BidModifier"];
+        readonly IncomeGradeAdjustmentFieldEnum: readonly ["BidModifier", "Enabled", "Grade"];
+        readonly MobileAdjustmentFieldEnum: readonly ["BidModifier", "OperatingSystemType"];
+        readonly RegionalAdjustmentFieldEnum: readonly ["BidModifier", "Enabled", "RegionId"];
+        readonly RetargetingAdjustmentFieldEnum: readonly ["Accessible", "BidModifier", "Enabled", "RetargetingConditionId"];
+        readonly SerpLayoutAdjustmentFieldEnum: readonly ["BidModifier", "Enabled", "SerpLayout"];
+        readonly SmartAdAdjustmentFieldEnum: readonly ["BidModifier"];
+        readonly SmartTvAdjustmentFieldEnum: readonly ["BidModifier"];
+        readonly TabletAdjustmentFieldEnum: readonly ["BidModifier", "OperatingSystemType"];
+        readonly VideoAdjustmentFieldEnum: readonly ["BidModifier"];
+    };
+    readonly bids: {
+        readonly BidFieldEnum: readonly ["AdGroupId", "AuctionBids", "AutotargetingSearchBidIsAuto", "Bid", "CampaignId", "CompetitorsBids", "ContextBid", "ContextCoverage", "CurrentSearchPrice", "KeywordId", "MinSearchPrice", "SearchPrices", "ServingStatus", "StrategyPriority"];
+    };
+    readonly businesses: {
+        readonly BusinessFieldEnum: readonly ["Address", "HasOffice", "Id", "InternalUrl", "IsPublished", "MergedIds", "Name", "Phone", "ProfileUrl", "Rubric", "Urls"];
+    };
+    readonly campaigns: {
+        readonly CampaignFieldEnum: readonly ["BlockedIps", "ClientInfo", "Currency", "DailyBudget", "EndDate", "ExcludedSites", "Funds", "Id", "Name", "NegativeKeywords", "Notification", "RepresentedBy", "SourceId", "StartDate", "State", "Statistics", "Status", "StatusClarification", "StatusPayment", "TimeTargeting", "TimeZone", "Type"];
+        readonly CpmBannerCampaignFieldEnum: readonly ["BiddingStrategy", "CounterIds", "FrequencyCap", "Settings", "VideoTarget"];
+        readonly DynamicTextCampaignFieldEnum: readonly ["AttributionModel", "BiddingStrategy", "CanBeUsedAsPackageBiddingStrategySource", "CounterIds", "NegativeKeywordSharedSetIds", "PackageBiddingStrategy", "PlacementTypes", "PriorityGoals", "Settings", "TrackingParams"];
+        readonly DynamicTextCampaignSearchStrategyPlacementTypesFieldEnum: readonly ["DynamicPlaces", "ProductGallery", "SearchResults"];
+        readonly MobileAppCampaignFieldEnum: readonly ["BiddingStrategy", "CanBeUsedAsPackageBiddingStrategySource", "NegativeKeywordSharedSetIds", "PackageBiddingStrategy", "Settings", "WeeklyBudgetRollover"];
+        readonly SmartCampaignFieldEnum: readonly ["AttributionModel", "BiddingStrategy", "CanBeUsedAsPackageBiddingStrategySource", "CounterId", "PackageBiddingStrategy", "PriorityGoals", "Settings", "TrackingParams"];
+        readonly TextCampaignFieldEnum: readonly ["AttributionModel", "BiddingStrategy", "CanBeUsedAsPackageBiddingStrategySource", "CounterIds", "NegativeKeywordSharedSetIds", "PackageBiddingStrategy", "PriorityGoals", "RelevantKeywords", "Settings", "TrackingParams", "WeeklyBudgetRollover"];
+        readonly TextCampaignSearchStrategyPlacementTypesFieldEnum: readonly ["DynamicPlaces", "ProductGallery", "SearchResults"];
+        readonly UnifiedCampaignFieldEnum: readonly ["AttributionModel", "BiddingStrategy", "CanBeUsedAsPackageBiddingStrategySource", "CounterIds", "NegativeKeywordSharedSetIds", "PackageBiddingStrategy", "PriorityGoals", "Settings", "TrackingParams", "WeeklyBudgetRollover"];
+        readonly UnifiedCampaignPackageBiddingStrategyPlatformsFieldEnum: readonly ["DynamicPlaces", "Maps", "Network", "ProductGallery", "SearchOrganizationList", "SearchResult"];
+        readonly UnifiedCampaignSearchStrategyPlacementTypesFieldEnum: readonly ["DynamicPlaces", "Maps", "ProductGallery", "SearchOrganizationList", "SearchResults"];
+    };
+    readonly changes: {
+        readonly CheckFieldEnum: readonly ["AdGroupIds", "AdIds", "CampaignIds", "CampaignsStat"];
+    };
+    readonly clients: {
+        readonly ClientFieldEnum: readonly ["AccountQuality", "Archived", "AvailableAdGroupTypes", "AvailableCampaignTypes", "Bonuses", "ClientId", "ClientInfo", "CountryId", "CreatedAt", "Currency", "ForbiddenPlatform", "Grants", "Login", "Notification", "OverdraftSumAvailable", "Phone", "Representatives", "Restrictions", "Settings", "Type", "VatRate"];
+    };
+    readonly creatives: {
+        readonly CpcVideoCreativeFieldEnum: readonly ["Duration"];
+        readonly CpmVideoCreativeFieldEnum: readonly ["Duration"];
+        readonly CreativeFieldEnum: readonly ["Associated", "Height", "Id", "IsAdaptive", "Name", "PreviewUrl", "ThumbnailUrl", "Type", "Width"];
+        readonly SmartCreativeFieldEnum: readonly ["BusinessType", "CreativeGroupId", "CreativeGroupName"];
+        readonly VideoExtensionCreativeFieldEnum: readonly ["Duration"];
+    };
+    readonly dictionaries: {
+        readonly GeoRegionFieldEnum: readonly ["GeoRegionId", "GeoRegionName", "ParentGeoRegionNames"];
+    };
+    readonly dynamictextadtargets: {
+        readonly WebpageFieldEnum: readonly ["AdGroupId", "Bid", "CampaignId", "ConditionType", "Conditions", "ContextBid", "Id", "Name", "State", "StatusClarification", "StrategyPriority"];
+    };
+    readonly feeds: {
+        readonly FeedFieldEnum: readonly ["BusinessType", "CampaignIds", "FilterSchema", "Id", "Name", "NumberOfItems", "NumberOfListings", "SourceType", "Status", "TitleAndTextSources", "UpdatedAt"];
+        readonly FileFeedFieldEnum: readonly ["Filename"];
+        readonly UrlFeedFieldEnum: readonly ["Login", "RemoveUtmTags", "Url"];
+    };
+    readonly keywordbids: {
+        readonly KeywordBidFieldEnum: readonly ["AdGroupId", "CampaignId", "KeywordId", "ServingStatus", "StrategyPriority"];
+        readonly KeywordBidNetworkFieldEnum: readonly ["Bid", "Coverage"];
+        readonly KeywordBidSearchFieldEnum: readonly ["AuctionBids", "AutotargetingSearchBidIsAuto", "Bid"];
+    };
+    readonly keywords: {
+        readonly KeywordFieldEnum: readonly ["AdGroupId", "AutotargetingBrandOptions", "AutotargetingCategories", "AutotargetingSearchBidIsAuto", "Bid", "CampaignId", "ContextBid", "Id", "Keyword", "Productivity", "ServingStatus", "State", "StatisticsNetwork", "StatisticsSearch", "Status", "StrategyPriority", "UserParam1", "UserParam2"];
+    };
+    readonly keywordsresearch: {
+        readonly HasSearchVolumeFieldEnum: readonly ["AllDevices", "Desktops", "Keyword", "MobilePhones", "RegionIds", "Tablets"];
+    };
+    readonly leads: {
+        readonly LeadFieldEnum: readonly ["Data", "Id", "SubmittedAt", "TurboPageId", "TurboPageName"];
+    };
+    readonly negativekeywordsharedsets: {
+        readonly NegativeKeywordSharedSetFieldEnum: readonly ["Associated", "Id", "Name", "NegativeKeywords"];
+    };
+    readonly retargetinglists: {
+        readonly RetargetingListFieldEnum: readonly ["AvailableForTargetsInAdGroupTypes", "Description", "Id", "IsAvailable", "Name", "Rules", "Scope", "Type"];
+    };
+    readonly sitelinks: {
+        readonly SitelinkFieldEnum: readonly ["Description", "Href", "Title", "TurboPageId"];
+        readonly SitelinksSetFieldEnum: readonly ["Id", "Sitelinks"];
+    };
+    readonly smartadtargets: {
+        readonly SmartAdTargetFieldEnum: readonly ["AdGroupId", "Audience", "AvailableItemsOnly", "AverageCpa", "AverageCpc", "CampaignId", "ConditionType", "Conditions", "Id", "Name", "State", "StrategyPriority"];
+    };
+    readonly strategies: {
+        readonly StrategyAverageCpaFieldEnum: readonly ["AverageCpa", "BidCeiling", "BudgetType", "CustomPeriodBudget", "ExplorationBudget", "GoalId", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyAverageCpaMultipleGoalsFieldEnum: readonly ["BidCeiling", "BudgetType", "CustomPeriodBudget", "ExplorationBudget", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyAverageCpaPerCampaignFieldEnum: readonly ["AverageCpa", "BidCeiling", "BudgetType", "CustomPeriodBudget", "ExplorationBudget", "GoalId", "WeeklySpendLimit"];
+        readonly StrategyAverageCpaPerFilterFieldEnum: readonly ["BidCeiling", "BudgetType", "CustomPeriodBudget", "ExplorationBudget", "FilterAverageCpa", "GoalId", "WeeklySpendLimit"];
+        readonly StrategyAverageCpcFieldEnum: readonly ["AverageCpc", "BudgetType", "CustomPeriodBudget", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyAverageCpcPerCampaignFieldEnum: readonly ["AverageCpc", "BidCeiling", "BudgetType", "CustomPeriodBudget", "WeeklySpendLimit"];
+        readonly StrategyAverageCpcPerFilterFieldEnum: readonly ["BidCeiling", "BudgetType", "CustomPeriodBudget", "FilterAverageCpc", "WeeklySpendLimit"];
+        readonly StrategyAverageCrrFieldEnum: readonly ["BudgetType", "Crr", "CustomPeriodBudget", "ExplorationBudget", "GoalId", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyFieldEnum: readonly ["AttributionModel", "CounterIds", "Id", "Name", "PriorityGoals", "StatusArchived", "Type"];
+        readonly StrategyMaximumClicksFieldEnum: readonly ["BidCeiling", "BudgetType", "CustomPeriodBudget", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyMaximumConversionRateFieldEnum: readonly ["BidCeiling", "BudgetType", "CustomPeriodBudget", "GoalId", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyMaxProfitFieldEnum: readonly ["BudgetType", "CustomPeriodBudget", "ExplorationBudget", "WeeklyBudgetRollover", "WeeklySpendLimit"];
+        readonly StrategyPayForConversionCrrFieldEnum: readonly ["BudgetType", "Crr", "CustomPeriodBudget", "GoalId", "WeeklySpendLimit"];
+        readonly StrategyPayForConversionFieldEnum: readonly ["BudgetType", "Cpa", "CustomPeriodBudget", "GoalId", "WeeklySpendLimit"];
+        readonly StrategyPayForConversionMultipleGoalsFieldEnum: readonly ["BudgetType", "CustomPeriodBudget", "WeeklySpendLimit"];
+        readonly StrategyPayForConversionPerCampaignFieldEnum: readonly ["BudgetType", "Cpa", "CustomPeriodBudget", "GoalId", "WeeklySpendLimit"];
+        readonly StrategyPayForConversionPerFilterFieldEnum: readonly ["BudgetType", "Cpa", "CustomPeriodBudget", "GoalId", "WeeklySpendLimit"];
+    };
+    readonly turbopages: {
+        readonly TurboPageFieldEnum: readonly ["BoundWithHref", "Href", "Id", "Name", "PreviewHref", "TurboSiteHref"];
+    };
+    readonly vcards: {
+        readonly VCardFieldEnum: readonly ["Apartment", "Building", "CampaignId", "City", "CompanyName", "ContactEmail", "ContactPerson", "Country", "ExtraMessage", "House", "Id", "InstantMessenger", "MetroStationId", "Ogrn", "Phone", "PointOnMap", "Street", "WorkTime"];
+    };
+    readonly "general.xsd": {
+        readonly AutotargetingBrandOptionsFieldEnum: readonly ["WithAdvertiserBrand", "WithCompetitorsBrand", "WithoutBrands"];
+        readonly AutotargetingCategoriesFieldEnum: readonly ["Accessory", "Alternative", "Broader", "Exact", "Narrow"];
+    };
+};
+type ApiService = keyof typeof API_FIELDS;
+export type FieldOf<S extends ApiService, E extends keyof (typeof API_FIELDS)[S]> = (typeof API_FIELDS)[S][E] extends readonly (infer Value)[] ? Value : never;
+export {};