hermoso 0.1.520 → 0.1.522

package/mcp/tools.mjs

@@ -18645,13 +18645,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 +19305,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'),
@@ -26036,7 +26039,10 @@ function memoryNoteVerdict(text) {
     // `pp`). Ungated, a SERVICE or APP brand acquired a "product library" from its own og:image — and brandContext
     // would then print "SERVICE BUSINESS — there is NO physical product. NEVER invent a box, bottle, package…"
     // directly above a populated photo library, while assembleAdRender attached that image to every render.
-    if (p && p.domain && p.physical_product !== false) {
+    // A CREATOR'S SITE IS READ FOR PHOTOS ONLY WHEN THE DRAFT NAMED A PRODUCT (journey QA 2026-11-05, @cookingwithlynja): the
+    // photo review is paid, and a handle draft's domain is usually a link-in-bio page. Same rule as the web (brandSellsProduct).
+    const _creatorNoProduct = !!a.socialHandle && !(Array.isArray(p?.productNames) && p.productNames.some((x) => typeof x === 'string' && x.trim()));
+    if (p && p.domain && p.physical_product !== false && !_creatorNoProduct) {
       try {
         const site = await apiGet('/api/site/images', { url: p.domain });
         const imgs = [...(site?.images || [])].filter(Boolean);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hermoso",
-  "version": "0.1.520",
+  "version": "0.1.522",
   "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",