hermoso 0.1.521 → 0.1.523

package/mcp/tools.mjs

@@ -3255,6 +3255,7 @@ const splitRef = (m, tool, word) => {
 // delete names the visibility operation. These run BEFORE the split rewrite, so a precise reference wins over the
 // generic "op / op" list.
 const WIDGET_PROXY_REFS = [[/\s*\/\s*fetch_social_data\b/g, ''], [/go through fetch_social_data with a handle/g, 'go through instagram_profile and search_instagram_hashtag'],
+  [/through fetch_social_data's Instagram profile endpoint/g, 'through instagram_profile'], // search_instagram's local-market step (0aec0d65db4)
   [/, which submit_tiktok_ads_verification can reuse/g, ''], [/the code submit_tiktok_ads_verification needs/g, 'its code'],
   [/SECRET with update_pinterest_board\b/g, 'SECRET with set_pinterest_board_visibility']];
 const widgetProxyHit = (d) => WIDGET_PROXY_REFS.some(([re]) => { re.lastIndex = 0; const hit = re.test(d); re.lastIndex = 0; return hit; });
@@ -18645,13 +18646,16 @@ function buildTools(rawServer, opts = {}, sink = null) {
     inputSchema: {
       advertiserId: z.string().optional().describe('from list_tiktok_ads_accounts — TikTok scopes these lookups to an advertiser'),
       kind: z.enum(['location', 'interest', 'interest_keyword', 'hashtag', 'language']).optional().describe('default location. interest_keyword and hashtag both REQUIRE keyword.'),
-      keyword: z.string().optional().describe('narrows the lookup, e.g. "Canada", "Beauty", "skincare"'),
+      keyword: z.string().optional().describe('narrows the lookup by name, e.g. "Canada" returns Canada rather than every place TikTok has; REQUIRED for interest_keyword and hashtag'),
+      regionCode: z.string().optional().describe('location only: two-letter country code, e.g. CA, to list the places inside one country'),
+      level: z.enum(['country', 'province', 'city', 'district']).optional().describe('location only: return one level'),
+      limit: z.number().optional().describe('rows to return, default 50, max 200; total always counts every match'),
     },
-    outputSchema: { advertiserId: z.string().optional(), kind: z.string().optional(), results: z.array(z.any()).optional() },
+    outputSchema: { advertiserId: z.string().optional(), kind: z.string().optional(), results: z.array(z.any()).optional(), total: z.number().optional(), returned: z.number().optional(), truncated: z.boolean().optional(), note: z.string().optional() },
     annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: true },
   }, wrap(async (a) => {
     const d = await apiGet('/api/tiktok-ads/targeting', a);
-    return ok(`${(d.results || []).length} TikTok ${d.kind || a.kind || 'location'} result(s) on advertiser ${d.advertiserId}:\n${JSON.stringify((d.results || []).slice(0, 30))}`, d);
+    return ok(`${d.note || `${(d.results || []).length} TikTok ${d.kind || a.kind || 'location'} result(s).`} Advertiser ${d.advertiserId}:\n${JSON.stringify(d.results || [])}`, d);
   }));
   server.registerTool('tiktok_ads_report', {
     title: 'TikTok ads performance report',
@@ -19302,7 +19306,7 @@ function buildTools(rawServer, opts = {}, sink = null) {
       registeredArea: z.string().optional().describe('two-letter country of registration, e.g. US'),
       timezone: z.string().optional().describe('IANA time zone, e.g. America/New_York'),
       currency: z.string().optional().describe('must match the Business Center currency; defaults to it'),
-      promotionLink: z.string().optional().describe('company website; required for an agency Business Center'),
+      promotionLink: z.string().optional().describe('company website; required for an agency Business Center. Pass the brand site when you have it: Hermoso sends it only where TikTok takes it and the reply says when it was not sent'),
       contactName: z.string().optional(), contactEmail: z.string().optional(), contactPhone: z.string().optional(),
       billingAddress: z.string().optional().describe('required for France, Brazil and Mexico'),
       taxId: z.string().optional().describe('VAT, tax id or ABN depending on the country'),
@@ -22631,7 +22635,7 @@ function buildTools(rawServer, opts = {}, sink = null) {
       image: z.string().optional().describe('the served absolute URL of the finished image'),
       model: z.string().optional().describe('the product-facing label of the model that rendered it'),
       productCheck: z.any().optional().describe('present when the brand\'s product photo was attached: {verdict: match|mismatch|unclear|absent, wordmark, issues[]} — the render compared against the real product photo. mismatch/absent means the product in the image is NOT the brand\'s product; say so, never present it as done'),
-      logoPlaced: z.any().optional().describe('how the real logo file went on: {applied, mode: in_scene|fix|overlay, object?, fellBack?, notALogo?}; notALogo = the saved logo is a photo, so nothing was added (ask for the logo file)'),
+      logoPlaced: z.any().optional().describe('how the real logo file went on: {applied, mode: in_scene|fix|overlay, object?, fellBack?, notALogo?, asked?}; notALogo = the saved logo is a photo, so nothing was added (ask for the logo file only when the logo was asked for; asked:false means nobody asked for one, so say nothing about it)'),
       labelPass: z.any().optional().describe('present when the product\'s label lines were known: {status: checked (read and already right, left as rendered) | fixed (read wrong and re-printed from the photo) | left (not re-printed: label faces away, product not found, or the pass could not run) | off (fixLabel:false), read, expected[], note}. Tell the user the note.'),
     },
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hermoso",
-  "version": "0.1.521",
+  "version": "0.1.523",
   "mcpName": "io.github.hermoso-ai/hermoso",
   "description": "AI marketing agent and AI ad generator, run from your own AI agent. 1177 tools. No markup on models on Starter and up. Publishing, scheduling, ad campaign management, comments, DMs and analytics cost no credits on any plan; Free includes 10 posts a month and every paid plan posts without a limit. AD PLATFORMS: Meta, Google Ads, TikTok Ads, LinkedIn Ads, Reddit Ads, X Ads, Pinterest Ads, Snapchat Ads, Microsoft Advertising, Apple Search Ads, ChatGPT Ads and AppLovin Ads, plus product feeds in Google Merchant Center. PUBLISHING AND SCHEDULING: Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, WordPress, Discord, Slack, Whop and Google Business Profile. INSTAGRAM DM AUTOMATIONS: a keyword comment, a DM, a story reply or an ig.me link gets an automatic private reply from the brand. AD RESEARCH: the Meta, Google and LinkedIn ad libraries plus organic TikTok, Instagram, YouTube, Threads and Reddit. ANALYTICS: Google Analytics 4, Google Search Console and every connected platform's own post and campaign insights. Also brand onboarding, 50+ image and video generation models, ad scoring, competitor teardowns, Google Drive and OneDrive, a CLI and installable Claude skills.",
   "type": "module",