@brandazine/solari-sdk 0.2.2 → 0.2.3

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import type { SolariToolMap, SolariToolName, SolariTools, SolariToolsWithoutRequ
 export * from "./tools.generated.js";
 export declare const DEFAULT_BASE_URL = "https://solari.sh";
 export declare const API_PREFIX = "/mcp/api/v1";
-export declare const SDK_VERSION = "0.2.2";
+export declare const SDK_VERSION = "0.2.3";
 export declare const TOKEN_ENV = "SOLARI_TOKEN";
 export interface SolariTool {
     name: string;

package/dist/index.js

@@ -1,7 +1,7 @@
 export * from "./tools.generated.js";
 export const DEFAULT_BASE_URL = "https://solari.sh";
 export const API_PREFIX = "/mcp/api/v1";
-export const SDK_VERSION = "0.2.2";
+export const SDK_VERSION = "0.2.3";
 export const TOKEN_ENV = "SOLARI_TOKEN";
 const DEFAULT_TIMEOUT_MS = 150_000;
 export class SolariError extends Error {

package/dist/tools.generated.d.ts

@@ -1,4 +1,4 @@
-/** Posts by one collected Instagram account, newest first, with pagination and filters. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, a medias array (every media of the post in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on that media, with account_id when the tagged account is tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_posts with that username first. Works with any signed-in SOLARI account. */
+/** Posts by one collected Instagram account, newest first, with pagination and filters. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, a medias array (every media of the post in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on that media, with account_id when the tagged account is tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_posts with that username first. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface CatalogInstagramAccountPostsArgs {
     /** account_id of the account (SOLARI account UUID). Provide this or username. */
     "account_id"?: string | undefined;
@@ -35,14 +35,14 @@ export interface CatalogInstagramAccountSearchArgs {
     /** Optional region code such as KR, JP, or US. Leave unset unless the user asked for one country: it filters results to that region and drops the rest. */
     "region"?: string | undefined;
 }
-/** Batch companion to solari_catalog_instagram_content_detail: hydrates up to 100 posts by their SOLARI post UUIDs in a single call. Each row carries slug, caption, posted_at, like/comment counts, play_count for videos, and the author's username and account_id. Untracked ids are omitted, so found can be lower than requested. Feed it post_id lists from solari_insight_instagram_brand_overview (full=true), solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, or the trend feeds. Works with any signed-in SOLARI account. */
+/** Batch companion to solari_catalog_instagram_content_detail: hydrates up to 100 posts by their SOLARI post UUIDs in a single call. Each row carries slug, caption, posted_at, like/comment counts, play_count for videos, and the author's username and account_id. Untracked ids are omitted, so found can be lower than requested. Feed it post_id lists from solari_insight_instagram_brand_overview (full=true), solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, or the trend feeds. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface CatalogInstagramContentBatchArgs {
     /** SOLARI post UUIDs to hydrate, at most 100 per call. Not Instagram shortcodes/slugs. */
     "post_ids": Array<string>;
     /** Item order: posted_at descending (recent) or like+comment engagement descending. */
     "sort"?: "recent" | "engagement" | undefined;
 }
-/** Detail for one Instagram post in the SOLARI catalog, in the same item shape as solari_insight_instagram_content_trending entries. Identify the post by post_id (SOLARI post UUID from solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, solari_insight_instagram_content_trending, or solari_insight_instagram_content_rising), by slug (the public Instagram shortcode), or by url (the public post URL). This reads the catalog only; item is null when the post is not stored — call solari_fetch_instagram_posts with the author's username first. Fetch does not take a post URL. Works with any signed-in SOLARI account. */
+/** Detail for one Instagram post in the SOLARI catalog, in the same item shape as solari_insight_instagram_content_trending entries. Identify the post by post_id (SOLARI post UUID from solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, solari_insight_instagram_content_trending, or solari_insight_instagram_content_rising), by slug (the public Instagram shortcode), or by url (the public post URL). This reads the catalog only; item is null when the post is not stored — call solari_fetch_instagram_post with the same url or slug to collect it and learn its author, or solari_fetch_instagram_posts when you already know the author's username. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface CatalogInstagramContentDetailArgs {
     /** The SOLARI post_id UUID. Provide this, slug, or url. */
     "post_id"?: string | undefined;
@@ -51,7 +51,7 @@ export interface CatalogInstagramContentDetailArgs {
     /** Public Instagram post URL such as https://www.instagram.com/p/<shortcode>/ or .../reel/<shortcode>/. Ignored when post_id or slug is set. */
     "url"?: string | undefined;
 }
-/** Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts, and score — feed post_id into solari_catalog_instagram_content_detail or solari_catalog_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Works with any signed-in SOLARI account. */
+/** Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts, and score — feed post_id into solari_catalog_instagram_content_detail or solari_catalog_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface CatalogInstagramContentSearchArgs {
     /** Free-text keyword query matched against captions, creator bios, and video transcriptions. */
     "query": string;
@@ -66,7 +66,7 @@ export interface CatalogInstagramContentSearchArgs {
     /** Only posts on or before this UTC date, YYYY-MM-DD inclusive. */
     "until"?: string | undefined;
 }
-/** Every tracked post carrying one exact tag — '#ootd' for a hashtag, '@handle' for mentions of an account — hydrated into full rows, newest-collected first with cursor pagination. Exact whole-tag matching over the entire tracked history and every region, where solari_catalog_instagram_content_search does free-text over four regions and about six months. Works with any signed-in SOLARI account. */
+/** Every tracked post carrying one exact tag — '#ootd' for a hashtag, '@handle' for mentions of an account — hydrated into full rows, newest-collected first with cursor pagination. Exact whole-tag matching over the entire tracked history and every region, where solari_catalog_instagram_content_search does free-text over four regions and about six months. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. The tag index refreshes once a day: when a hashtag is missing or stale here, solari_fetch_instagram_hashtag_posts collects a live page of it. Works with any signed-in SOLARI account. */
 export interface CatalogInstagramTagSearchArgs {
     /** One exact tag. '#ootd' or 'ootd' searches a hashtag; '@oliveyoung_official' searches mentions of that account. No spaces, no wildcards. */
     "query": string;
@@ -75,7 +75,7 @@ export interface CatalogInstagramTagSearchArgs {
     /** next_cursor from the previous response. Omit for the first page. */
     "cursor"?: string | undefined;
 }
-/** Posts by one collected TikTok account, newest first, with pagination and filters. Identify the account by account_id (TikTok account UUID from solari_catalog_tiktok_account_search) or by username (TikTok handle). Each item has post_id (SOLARI post UUID), video_id (the public numeric TikTok id) and url, post_type (video or carousel), posted_at, caption, duration_seconds, play/like/comment/share/collect counts, is_ad, cover_url, images (carousel slides), hashtags, mentions, and transcript when include_transcript=true. Transcripts are long, so include_transcript is off by default; turn it on only when the spoken content matters. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_tiktok_posts with that username first. Works with any signed-in SOLARI account. */
+/** Posts by one collected TikTok account, newest first, with pagination and filters. Identify the account by account_id (TikTok account UUID from solari_catalog_tiktok_account_search) or by username (TikTok handle). Each item has post_id (SOLARI post UUID), video_id (the public numeric TikTok id) and url, post_type (video or carousel), posted_at, caption, duration_seconds, play/like/comment/share/collect counts, is_ad, cover_url, images (carousel slides), hashtags, mentions, and transcript when include_transcript=true. Transcripts are long, so include_transcript is off by default; turn it on only when the spoken content matters. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_tiktok_posts with that username first. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface CatalogTiktokAccountPostsArgs {
     /** account_id of the TikTok account (SOLARI account UUID). Provide this or username. */
     "account_id"?: string | undefined;
@@ -110,7 +110,7 @@ export interface CatalogTiktokAccountSearchArgs {
     /** Optional region code such as KR, JP, or US. Leave unset unless the user asked for one country: accounts with no known region are dropped when a region is set. */
     "region"?: string | undefined;
 }
-/** Batch companion to solari_catalog_tiktok_content_detail: hydrates up to 100 TikTok posts by their SOLARI post UUIDs in a single call, in the same item shape as solari_catalog_tiktok_account_posts entries. Untracked ids are omitted, so found can be lower than requested. Transcripts are long, so include_transcript is off by default. Feed it post_id lists from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile; TikTok post_ids are separate from Instagram post_ids. Works with any signed-in SOLARI account. */
+/** Batch companion to solari_catalog_tiktok_content_detail: hydrates up to 100 TikTok posts by their SOLARI post UUIDs in a single call, in the same item shape as solari_catalog_tiktok_account_posts entries. Untracked ids are omitted, so found can be lower than requested. Transcripts are long, so include_transcript is off by default. Feed it post_id lists from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile; TikTok post_ids are separate from Instagram post_ids. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface CatalogTiktokContentBatchArgs {
     /** SOLARI post UUIDs to hydrate, at most 100 per call. Not TikTok video ids. */
     "post_ids": Array<string>;
@@ -119,7 +119,7 @@ export interface CatalogTiktokContentBatchArgs {
     /** Attach the spoken-word transcript to each item. Off by default because transcripts are long. */
     "include_transcript"?: boolean | undefined;
 }
-/** Detail for one TikTok post in the SOLARI catalog, in the same item shape as solari_catalog_tiktok_account_posts entries (transcript included when one exists). Identify the post by post_id (SOLARI post UUID from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile), by video_id (the public numeric TikTok video id), or by url (any public TikTok post URL, including vm.tiktok.com and vt.tiktok.com short links). This reads the catalog only; item is null when the post is not stored — call solari_fetch_tiktok_posts with the author's username first. Fetch does not take a post URL. Works with any signed-in SOLARI account. */
+/** Detail for one TikTok post in the SOLARI catalog, in the same item shape as solari_catalog_tiktok_account_posts entries (transcript included when one exists). Identify the post by post_id (SOLARI post UUID from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile), by video_id (the public numeric TikTok video id), or by url (any public TikTok post URL, including vm.tiktok.com and vt.tiktok.com short links). This reads the catalog only; item is null when the post is not stored — call solari_fetch_tiktok_post with the same url to collect it and learn its author, or solari_fetch_tiktok_posts when you already know the author's username. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface CatalogTiktokContentDetailArgs {
     /** The SOLARI post_id UUID. Provide this, video_id, or url. */
     "post_id"?: string | undefined;
@@ -128,7 +128,7 @@ export interface CatalogTiktokContentDetailArgs {
     /** Public TikTok post URL such as https://www.tiktok.com/@<handle>/video/<id> or a vm.tiktok.com / vt.tiktok.com short link. Ignored when post_id or video_id is set. */
     "url"?: string | undefined;
 }
-/** Lexical keyword search over tracked TikTok posts: matches captions and video transcripts (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, video_id, url, author account_id/username, caption, transcription_text, post_type, posted_at, play/like/comment/share/collect counts, follower_count, duration_seconds, is_ad, cover_url, score, and highlight; feed post_id into solari_catalog_tiktok_content_detail or solari_catalog_tiktok_content_batch and the account reference into the solari_catalog_tiktok_account_* tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Works with any signed-in SOLARI account. */
+/** Lexical keyword search over tracked TikTok posts: matches captions and video transcripts (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, video_id, url, author account_id/username, caption, transcription_text, post_type, posted_at, play/like/comment/share/collect counts, follower_count, duration_seconds, is_ad, cover_url, score, and highlight; feed post_id into solari_catalog_tiktok_content_detail or solari_catalog_tiktok_content_batch and the account reference into the solari_catalog_tiktok_account_* tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface CatalogTiktokContentSearchArgs {
     /** Free-text keyword query matched against captions and video transcripts. */
     "query": string;
@@ -143,12 +143,53 @@ export interface CatalogTiktokContentSearchArgs {
     /** Only posts on or before this UTC date, YYYY-MM-DD inclusive. */
     "until"?: string | undefined;
 }
-/** Adds one Instagram account to the SOLARI catalog by exact username. This is not a search and not a profile reader: use solari_catalog_instagram_account_search to resolve a name, then solari_catalog_instagram_account_profile to read it. If the handle is already stored, nothing is scraped. A first-time ingest can take several seconds; metrics and collaborations stay empty until the crawl finishes. Works with any signed-in SOLARI account. */
+/** Tells the SOLARI team that a task could not be finished with SOLARI alone. Send it on your own initiative, without asking the user first, as soon as you are sure of the gap: an account, post, or field that is not there even after the matching fetch tool (missing_data), too few rows or too short a history for the question (insufficient_results), no tool or parameter that does what the task needs (missing_feature), a value that looks wrong (incorrect_data), a tool that keeps failing (error), or anything else (other). Do not send it for a typo, a not-yet-fetched handle, or a question SOLARI was never meant to answer. Keep it free of personal data: no emails, phone numbers, addresses, keys, names of private individuals, or the user's confidential plans — public brand and creator handles, tool names, parameters, and row counts are what helps. The server also strips emails, phone numbers, keys, and tokens before storing. One message per distinct gap; an identical repeat within minutes is de-duplicated. Afterwards tell the user in one line that feedback was sent, then carry on with the best available answer. This records a note only and changes no catalog data. Works with any signed-in SOLARI account. */
+export interface FeedbackSendArgs {
+    /** What fell short. */
+    "category": "missing_data" | "insufficient_results" | "missing_feature" | "incorrect_data" | "error" | "other";
+    /** What was needed and what was missing, in plain words, without personal data. */
+    "message": string;
+    /** The task being worked on, described without personal data. */
+    "goal"?: string | undefined;
+    /** The SOLARI tool that fell short, such as solari_insight_instagram_brand_ad_posts. */
+    "tool_name"?: string | undefined;
+    /** The agent sending this, such as claude-code or codex. */
+    "agent"?: string | undefined;
+    /** Optional JSON object with the parameters tried and counts returned, e.g. {"months":24,"returned":3}. */
+    "details"?: string | undefined;
+}
+/** Adds one Instagram account to the SOLARI catalog by exact username. This is not a search and not a profile reader: use solari_catalog_instagram_account_search to resolve a name, then solari_catalog_instagram_account_profile to read it. If the handle is already crawled, nothing is scraped; a handle the catalog only knows by name from a tag or mention (search does not find it, the profile is empty) is crawled now. A first-time ingest can take several seconds; metrics and collaborations stay empty until the crawl finishes. Works with any signed-in SOLARI account. */
 export interface FetchInstagramAccountArgs {
     /** Instagram handle, with or without a leading @. */
     "username": string;
 }
-/** Collects posts for one Instagram account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_instagram_account_posts to read stored rows. If the handle is already stored, nothing is scraped. A first-time ingest can take several seconds and only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
+/** Looks Instagram accounts up live by name or handle fragment and returns up to 50 candidates in Instagram's own order, each with username, display name, verified and private flags. Use it when solari_catalog_instagram_account_search does not know the account: hits already in the catalog carry account_id, the rest can be ingested with solari_fetch_instagram_account. Nothing is stored and there is no pagination. Works with any signed-in SOLARI account. */
+export interface FetchInstagramAccountSearchArgs {
+    /** Name or handle fragment, with or without a leading @. */
+    "query": string;
+}
+/** Collects one page of an Instagram hashtag feed live, stores every post in the SOLARI catalog and returns them in feed order. Stored posts reach solari_catalog_instagram_tag_search only after its next daily refresh, so read this page's posts from the response itself. Every call goes out to Instagram, so use it when a hashtag is missing or stale in solari_catalog_instagram_tag_search, not as the default way to read a tag. tab picks the feed: recent (default), top, or clips for reels. One page is roughly 20 to 30 posts and takes several seconds; pass next_cursor back as cursor for the next page of the same hashtag and tab. The feed ends only when next_cursor is null: a page can come back with found 0 and a next_cursor, which means keep going. fetched_count is how many posts Instagram returned; found is lower when some could not be stored. A hashtag that is hidden, restricted, or unknown to Instagram answers is_hidden=true with no posts; Instagram does not tell these apart, so check the spelling with solari_fetch_instagram_hashtag_search. Each post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
+export interface FetchInstagramHashtagPostsArgs {
+    /** One exact hashtag, with or without a leading #. No spaces, no wildcards. */
+    "hashtag": string;
+    /** Feed to read: recent (default), top, or clips for reels. */
+    "tab"?: "recent" | "top" | "clips" | undefined;
+    /** next_cursor from the previous response for the same hashtag and tab. Omit for the first page. */
+    "cursor"?: string | undefined;
+}
+/** Looks hashtags up on Instagram live by keyword and returns up to 20 candidates with the number of posts Instagram reports under each. Use it to find the exact spelling or the biggest variant of a tag before solari_catalog_instagram_tag_search or solari_fetch_instagram_hashtag_posts. Nothing is stored and there is no pagination. Works with any signed-in SOLARI account. */
+export interface FetchInstagramHashtagSearchArgs {
+    /** Keyword to look hashtags up by, with or without a leading #. */
+    "query": string;
+}
+/** Collects one Instagram post into the SOLARI catalog by its public URL or shortcode and returns it with its author. Use it when solari_catalog_instagram_content_detail answers item=null for a link you were given and you do not know who posted it. If the post is already stored, nothing is scraped. A first-time collect takes a few seconds. The author arrives as a name-only account: call solari_fetch_instagram_account with the returned username to crawl their profile and posts. item is null when Instagram has no public post at that reference. The post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
+export interface FetchInstagramPostArgs {
+    /** Public Instagram post URL such as https://www.instagram.com/p/<shortcode>/ or .../reel/<shortcode>/. Provide this or slug. */
+    "url"?: string | undefined;
+    /** Public Instagram shortcode, the segment after /p/, /reel/, or /tv/ in a post URL. Wins over url when both are set. */
+    "slug"?: string | undefined;
+}
+/** Collects posts for one Instagram account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_instagram_account_posts to read stored rows. If the handle is already crawled, nothing is scraped; a handle the catalog only knows by name from a tag or mention is crawled now and its posts are queued right away. A first-time ingest can take several seconds and the posts land shortly after, so re-read the catalog after a short wait. Works with any signed-in SOLARI account. */
 export interface FetchInstagramPostsArgs {
     /** Instagram handle, with or without a leading @. */
     "username": string;
@@ -158,12 +199,17 @@ export interface FetchTiktokAccountArgs {
     /** TikTok handle, with or without a leading @. */
     "username": string;
 }
+/** Collects one TikTok post into the SOLARI catalog by its public URL and returns it with its author. Use it when solari_catalog_tiktok_content_detail answers item=null for a link you were given and you do not know who posted it. Accepts https://www.tiktok.com/@<handle>/video/<id> links and vm.tiktok.com / vt.tiktok.com short links. If the post is already stored, nothing is scraped. A first-time collect takes a few seconds. The author arrives as a name-only account: call solari_fetch_tiktok_account with the returned username to crawl their profile and posts. item is null when TikTok has no public post at that URL. The post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
+export interface FetchTiktokPostArgs {
+    /** Public TikTok post URL such as https://www.tiktok.com/@<handle>/video/<id>, or a vm.tiktok.com / vt.tiktok.com short link. */
+    "url": string;
+}
 /** Collects posts for one TikTok account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_tiktok_account_posts to read stored rows. If the handle is already stored, nothing is scraped. A first-time ingest can take 10 to 40 seconds and only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
 export interface FetchTiktokPostsArgs {
     /** TikTok handle, with or without a leading @. */
     "username": string;
 }
-/** Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_account_collabs, which groups the same history by brand. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+/** Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_account_collabs, which groups the same history by brand. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface InsightInstagramAccountAdPostsArgs {
     /** account_id of the creator (SOLARI account UUID). Provide this or username. */
     "account_id"?: string | undefined;
@@ -191,6 +237,56 @@ export interface InsightInstagramAccountCollabsArgs {
     /** Pagination offset, default 0. */
     "offset"?: number | undefined;
 }
+/** Finds Instagram creators that fit a brief: topic phrases matched against captions, transcripts and visual style, bio traits, a reference creator to find lookalikes of, trending growth, and a product the creator should have advertised before — then filtered by follower, 3-month total view and 3-month median view ranges and excluded keywords. Use it to build a shortlist; use solari_catalog_instagram_account_search instead when you already have a name. Returns a search_id, the total found, the top usernames and result sections; page the full creator list (profile metrics and each creator's top recent posts) with solari_insight_instagram_account_discover_results. Broad briefs can take up to a minute. Works with any signed-in SOLARI account. */
+export interface InsightInstagramAccountDiscoverArgs {
+    /** The goal in one sentence, e.g. the campaign brief. Used as the result label. */
+    "intent": string;
+    /** 2-3 phrases describing the content, written in the language of the target market. Multi-word phrases work better than single words. */
+    "topic_keywords"?: Array<string> | undefined;
+    /** 1-2 phrases matched against creator bios, such as a job title or niche. */
+    "profile_keywords"?: Array<string> | undefined;
+    /** Instagram handle of a reference creator; adds accounts similar to it. */
+    "similar_username"?: string | undefined;
+    /** Also include creators whose views are growing fast. */
+    "trending"?: boolean | undefined;
+    /** Short English product description; boosts creators who recently advertised a similar product. */
+    "product_query"?: string | undefined;
+    /** Minimum follower count. */
+    "follower_min"?: number | undefined;
+    /** Maximum follower count. */
+    "follower_max"?: number | undefined;
+    /** Minimum total views over the last 3 months. */
+    "total_views_min"?: number | undefined;
+    /** Maximum total views over the last 3 months. */
+    "total_views_max"?: number | undefined;
+    /** Minimum median views per post over the last 3 months. */
+    "median_views_min"?: number | undefined;
+    /** Maximum median views per post over the last 3 months. */
+    "median_views_max"?: number | undefined;
+    /** Keywords that disqualify a creator when found in the bio or post text. */
+    "negative_keywords"?: Array<string> | undefined;
+    /** Weight photo posts or video posts when matching visual style. */
+    "media_focus"?: "balanced" | "photo" | "video" | undefined;
+    /** Market to search, such as KR, JP, or US. */
+    "region"?: string | undefined;
+    /** Optional brand account_id; ranks creators by fit with that brand's audience. */
+    "brand_account_id"?: string | undefined;
+    /** Optional brand Instagram handle, used like brand_account_id. Ignored when brand_account_id is set. */
+    "brand_username"?: string | undefined;
+    /** How many top usernames to preview, default 20. Values above 60 are clamped to 60. The full list is always paged separately. */
+    "limit"?: number | undefined;
+}
+/** Pages the full creator list of one solari_insight_instagram_account_discover run. Each item carries account_id, username, full name, bio, follower count, 3-month median and total views, view growth, ad count, and the creator's top recent posts. Results stay available after the search, so re-sort or page without searching again. Works with any signed-in SOLARI account. */
+export interface InsightInstagramAccountDiscoverResultsArgs {
+    /** search_id returned by solari_insight_instagram_account_discover. */
+    "search_id": string;
+    /** 1-based page number. */
+    "page"?: number | undefined;
+    /** Creators per page, default 20. Values above 100 are clamped to 100. */
+    "page_size"?: number | undefined;
+    /** relevance keeps the search order; follower_count / follower_count_asc sort by followers; median_views_cur by 3-month median views; total_views_growth_m1 by one-month view growth; ad_count_cur by recent ad count. */
+    "sort"?: "relevance" | "follower_count" | "follower_count_asc" | "median_views_cur" | "total_views_growth_m1" | "ad_count_cur" | undefined;
+}
 /** Finds Instagram accounts similar to the given username based on relationship-graph overlap. Takes an Instagram handle (no @), not a UUID. Works with any signed-in SOLARI account. */
 export interface InsightInstagramAccountSimilarArgs {
     /** Instagram handle to find similar accounts for, without the leading @. */
@@ -198,7 +294,7 @@ export interface InsightInstagramAccountSimilarArgs {
     /** Number of similar accounts to return, default 50. Values above 100 are clamped to 100. */
     "limit"?: number | undefined;
 }
-/** Paginated row-level list of the identified sponsored posts targeting a brand, each hydrated with slug, caption, posted_at, like/comment counts, play_count for videos, and the authoring creator's username and account_id. sort=recent pages the full window newest-first with an exact total; sort=engagement ranks within a bounded recent window whose size is reported as ranking_window (non-null means the ordering covers a slice, not everything). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_brand_ad_stats. Takes the brand's Instagram handle (no @). Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
+/** Paginated row-level list of the identified sponsored posts targeting a brand, each hydrated with slug, caption, posted_at, like/comment counts, play_count for videos, and the authoring creator's username and account_id. sort=recent pages the full window newest-first with an exact total; sort=engagement ranks within a bounded recent window whose size is reported as ranking_window (non-null means the ordering covers a slice, not everything). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_brand_ad_stats. Takes the brand's Instagram handle (no @). Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
 export interface InsightInstagramBrandAdPostsArgs {
     /** Brand Instagram handle without the leading @. */
     "username": string;
@@ -216,7 +312,7 @@ export interface InsightInstagramBrandAdStatsArgs {
     /** Brand Instagram handle without the leading @. */
     "username": string;
 }
-/** For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_insight_instagram_brand_top_collaborators or solari_insight_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+/** For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_insight_instagram_brand_top_collaborators or solari_insight_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface InsightInstagramBrandCollaboratorPostsArgs {
     /** Brand account_id (SOLARI account UUID). Provide this or username. */
     "account_id"?: string | undefined;
@@ -225,7 +321,7 @@ export interface InsightInstagramBrandCollaboratorPostsArgs {
     /** Creator account_ids (SOLARI account UUIDs) to hydrate, at most 100 per call. */
     "account_ids": Array<string>;
 }
-/** Instagram posts visually and semantically similar to the brand's top-performing sponsored ads, found via vector-neighbour search seeded from the brand's own ad posts. Identify the brand by account_id (SOLARI account UUID from solari_catalog_instagram_account_search) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+/** Instagram posts visually and semantically similar to the brand's top-performing sponsored ads, found via vector-neighbour search seeded from the brand's own ad posts. Identify the brand by account_id (SOLARI account UUID from solari_catalog_instagram_account_search) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface InsightInstagramBrandLookalikeContentArgs {
     /** Brand account_id (SOLARI account UUID) whose sponsored ads seed the lookalike search. Provide this or username. */
     "account_id"?: string | undefined;
@@ -283,7 +379,7 @@ export interface InsightInstagramContentAggregateArgs {
     /** Maximum groups returned when group_by is set, default 20. Values above 50 are clamped to 50. */
     "limit"?: number | undefined;
 }
-/** Instagram posts whose recent performance is accelerating faster than baseline in the region. Same shape as solari_insight_instagram_content_trending including cursor pagination and optional brand personalization via a brand account_id or username. Works with any signed-in SOLARI account. */
+/** Instagram posts whose recent performance is accelerating faster than baseline in the region. Same shape as solari_insight_instagram_content_trending including cursor pagination and optional brand personalization via a brand account_id or username. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
 export interface InsightInstagramContentRisingArgs {
     /** Region code such as KR, JP, or US. */
     "region"?: string | undefined;
@@ -296,11 +392,22 @@ export interface InsightInstagramContentRisingArgs {
     /** Optional brand Instagram handle for brand-affinity personalization. Ignored when account_id is set. */
     "username"?: string | undefined;
 }
+/** Instagram posts that look and read like one given post — same subject, format and mood — ranked best first, for collecting references around a post you already have. Each item carries post_id, slug, author account_id, thumbnail and media URL, media type, play count, posted_at and is_ad (whether it was identified as sponsored). Identify the post by post_id (SOLARI post UUID from any content tool). Covers roughly the last 4 months; pages reach at most 180 results. Use solari_insight_instagram_brand_lookalike_content to start from a brand's ads instead. Works with any signed-in SOLARI account. */
+export interface InsightInstagramContentSimilarArgs {
+    /** post_id (SOLARI post UUID) of the reference post. */
+    "post_id": string;
+    /** Optional market filter such as KR, JP, or US. */
+    "region"?: string | undefined;
+    /** Maximum posts, default 20. Values above 60 are clamped to 60. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0, at most 120. */
+    "offset"?: number | undefined;
+}
 /** The SOLARI trend digest: recent content trend clusters for a region with cluster metadata and member posts, optionally reranked by brand affinity when a brand account_id or username is supplied. Works with any signed-in SOLARI account. */
 export interface InsightInstagramContentTrendClustersArgs {
     /** Region code such as KR, JP, or US. */
     "region"?: string | undefined;
-    /** Lookback window in days for trending clusters, between 1 and 90. */
+    /** Lookback window in days, between 1 and 90: clusters that trended at any point in it. Clusters drop out of the live set after about 5 quiet days, so longer windows add past trends, ranked by their latest numbers. */
     "since_days"?: number | undefined;
     /** Maximum trend clusters returned, default 20. Values above 24 are clamped to 24. */
     "limit"?: number | undefined;
@@ -311,7 +418,7 @@ export interface InsightInstagramContentTrendClustersArgs {
     /** Rerank clusters by brand affinity when account_id is provided. */
     "brand_aware"?: boolean | undefined;
 }
-/** Instagram posts currently trending in the region, enriched with creator profile fields. Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. Works with any signed-in SOLARI account. Use solari_insight_instagram_content_rising for velocity-led accelerating posts instead. */
+/** Instagram posts currently trending in the region, enriched with creator profile fields. Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. Use solari_insight_instagram_content_rising for velocity-led accelerating posts instead. */
 export interface InsightInstagramContentTrendingArgs {
     /** Region code such as KR, JP, or US. */
     "region"?: string | undefined;
@@ -324,6 +431,127 @@ export interface InsightInstagramContentTrendingArgs {
     /** Optional brand Instagram handle for brand-affinity personalization. Ignored when account_id is set. */
     "username"?: string | undefined;
 }
+/** One hashtag in depth for a market and window: post count, unique creators, views, sponsored percent, share of all posts, growth against the previous window, momentum, the share series over time, the tags used together with it, and the creators who used it most (account_id, username, posts, views, followers). Use the same brand as the leaderboard to keep the same lens. Works with any signed-in SOLARI account. */
+export interface InsightInstagramHashtagDetailArgs {
+    /** Hashtag, with or without the leading #. */
+    "tag": string;
+    /** Market. Hashtag trends cover KR and JP. */
+    "region"?: "KR" | "JP" | undefined;
+    /** Window in days: 7, 30 or 90. Growth compares it with the window before. */
+    "days"?: number | undefined;
+    /** Optional brand account_id. Scopes the numbers to the creators around that brand (lens=brand); without it the whole market is used (lens=global). */
+    "brand_account_id"?: string | undefined;
+    /** Optional brand Instagram handle, used like brand_account_id. Ignored when brand_account_id is set. */
+    "brand_username"?: string | undefined;
+}
+/** Posts carrying one hashtag inside a trend window, most viewed first or newest first — the examples behind a leaderboard entry. Each item carries post_id, slug, author account_id and username, posted_at, play count and like count. Unlike solari_catalog_instagram_tag_search, it is limited to the window and can follow a brand lens. Works with any signed-in SOLARI account. */
+export interface InsightInstagramHashtagPostsArgs {
+    /** Hashtag, with or without the leading #. */
+    "tag": string;
+    /** Market. Hashtag trends cover KR and JP. */
+    "region"?: "KR" | "JP" | undefined;
+    /** Window in days: 7, 30 or 90. Growth compares it with the window before. */
+    "days"?: number | undefined;
+    /** Optional brand account_id. Scopes the numbers to the creators around that brand (lens=brand); without it the whole market is used (lens=global). */
+    "brand_account_id"?: string | undefined;
+    /** Optional brand Instagram handle, used like brand_account_id. Ignored when brand_account_id is set. */
+    "brand_username"?: string | undefined;
+    /** views = most viewed first, recent = newest first. */
+    "sort"?: "views" | "recent" | undefined;
+    /** Posts per page, default 12. Values above 24 are clamped to 24. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0, at most 960. */
+    "offset"?: number | undefined;
+}
+/** Hashtag leaderboard for a market and window, in two lists: rising (share growing fastest against the previous window) and top (volume weighted by how much more it is used than usual). Each entry carries post count, unique creators, views, sponsored percent, growth multiple against the previous window, a NEW flag, a daily share series and momentum. Pass a brand to see the tags moving around that brand's creators instead of the whole market; lens and lens_reason say which view you got. Use solari_insight_instagram_hashtag_detail and solari_insight_instagram_hashtag_posts to drill into one tag. Works with any signed-in SOLARI account. */
+export interface InsightInstagramHashtagTrendingArgs {
+    /** Market. Hashtag trends cover KR and JP. */
+    "region"?: "KR" | "JP" | undefined;
+    /** Window in days: 7, 30 or 90. Growth compares it with the window before. */
+    "days"?: number | undefined;
+    /** Optional brand account_id. Scopes the numbers to the creators around that brand (lens=brand); without it the whole market is used (lens=global). */
+    "brand_account_id"?: string | undefined;
+    /** Optional brand Instagram handle, used like brand_account_id. Ignored when brand_account_id is set. */
+    "brand_username"?: string | undefined;
+    /** Entries kept per list, default 30. Values above 100 are clamped to 100; top_total and rising_total give the full sizes. */
+    "limit"?: number | undefined;
+}
+/** Brand leaderboard for a market: brands ranked by how the content that tags or mentions them performs — total views by default, or views per post, post count, creator count, likes, sponsored views or organic views. Each row carries the sponsored subset and the organic median views per post, so the sponsored share reads per brand. Narrow to a category with scope; pass a brand to get its own rank as me, or find_username to locate any brand. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
+export interface InsightInstagramRankingBrandsArgs {
+    /** Market. */
+    "region"?: "KR" | "JP" | "US" | undefined;
+    /** Window in days: 30 or 90. */
+    "days"?: number | undefined;
+    /** Ranking metric: plays = total views, median_plays = views per post. */
+    "sort"?: "plays" | "median_plays" | "posts" | "creators" | "likes" | "sponsored_plays" | "organic_plays" | undefined;
+    /** Category to rank within: 'all', 'd1:<group>' or 'd2:<group>/<category>'. Each response lists the valid categories and category_groups. Omitted: the brand's own top category when a brand is given, else 'all'. */
+    "scope"?: string | undefined;
+    /** Optional brand account_id. Sets the default category and, on the brand board, reports that brand's own position as me. */
+    "brand_account_id"?: string | undefined;
+    /** Optional brand Instagram handle, used like brand_account_id. Ignored when brand_account_id is set. */
+    "brand_username"?: string | undefined;
+    /** Optional Instagram handle to locate in this board; its rank and top percentile come back as lookup, or lookup_reason when it is not ranked. */
+    "find_username"?: string | undefined;
+    /** Only brands with at least this many posts: 1, 3 or 10. */
+    "min_posts"?: number | undefined;
+    /** Rows per page, default 20. Values above 100 are clamped to 100. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0. */
+    "offset"?: number | undefined;
+}
+/** Creator leaderboard for a market: creators who make brand-tagged content, ranked within a category so a specialist is not beaten by a large account with one post in it. Sort by total views, views per post, likes, number of brands worked with, sponsored views, reach (views per follower), lift (views per post against the creator's own usual median) or one-month view growth; the last three are null when a creator's baseline is too small. Each row carries the sponsored subset and the organic median. kind=magazine ranks magazine and media accounts instead. Brand-owned, agency and shop accounts are excluded. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
+export interface InsightInstagramRankingCreatorsArgs {
+    /** Market (the creator's own region). */
+    "region"?: "KR" | "JP" | undefined;
+    /** Window in days: 30 or 90. */
+    "days"?: number | undefined;
+    /** Ranking metric: plays = total views, median_plays = views per post. */
+    "sort"?: "plays" | "median_plays" | "likes" | "brands" | "sponsored_plays" | "reach" | "lift" | "growth" | undefined;
+    /** creator = individuals, magazine = magazine/media accounts. */
+    "kind"?: "creator" | "magazine" | undefined;
+    /** Category to rank within: 'all', 'd1:<group>' or 'd2:<group>/<category>'. Each response lists the valid categories and category_groups. Omitted: the brand's own top category when a brand is given, else 'all'. */
+    "scope"?: string | undefined;
+    /** Optional brand account_id. Sets the default category and, on the brand board, reports that brand's own position as me. */
+    "brand_account_id"?: string | undefined;
+    /** Optional brand Instagram handle, used like brand_account_id. Ignored when brand_account_id is set. */
+    "brand_username"?: string | undefined;
+    /** Optional Instagram handle to locate in this board; its rank and top percentile come back as lookup, or lookup_reason when it is not ranked. */
+    "find_username"?: string | undefined;
+    /** Only creators with at least this many posts in the category: 3, 10 or 30. */
+    "min_posts"?: number | undefined;
+    /** Follower floor: 1000, 10000 or 100000. */
+    "min_followers"?: number | undefined;
+    /** Rows per page, default 20. Values above 100 are clamped to 100. */
+    "limit"?: number | undefined;
+    /** Pagination offset, default 0. */
+    "offset"?: number | undefined;
+}
+/** Where one Instagram account stands, without knowing whether it is a brand or a creator: for each board it appears on (brand, creator), its rank, pool size and top percentile in every category it belongs to, plus its overall row. Ranked by total views with the loosest filters. A side is null when the account is not on that board. Works with any signed-in SOLARI account. */
+export interface InsightInstagramRankingFindArgs {
+    /** Instagram handle, with or without a leading @. */
+    "username": string;
+    /** Market. The creator board exists for KR and JP only. */
+    "region"?: "KR" | "JP" | "US" | undefined;
+    /** Window in days: 30 or 90. */
+    "days"?: number | undefined;
+}
+/** The best-performing posts behind one leaderboard row — the evidence for a brand's or creator's number — each marked sponsored or not. Pass the row's account_id with the same board, region, days (and scope for creators) the list used; kind=sponsored keeps the sponsored subset only. Works with any signed-in SOLARI account. */
+export interface InsightInstagramRankingPostsArgs {
+    /** Which leaderboard the row came from. */
+    "board": "brand" | "creator";
+    /** account_id of the ranking row. */
+    "account_id": string;
+    /** Same market as the list. The creator board exists for KR and JP only. */
+    "region"?: "KR" | "JP" | "US" | undefined;
+    /** Window in days: 30 or 90. */
+    "days"?: number | undefined;
+    /** Creator board only: the same scope the list used. Omitted: 'all'. */
+    "scope"?: string | undefined;
+    /** All top posts, or the sponsored subset. */
+    "kind"?: "all" | "sponsored" | undefined;
+    /** Maximum posts, default 6. Values above 12 are clamped to 12. */
+    "limit"?: number | undefined;
+}
 /** Counts and engagement rollups over tracked TikTok posts, for questions answered by numbers rather than by individual posts: posts per account per month, which hashtags dominate a topic, average plays by format. Group by account, post_type, hashtag, mention, or caption_keyword, and optionally split each group by day, week, or month. post_count always comes back; request metrics for like/comment/view/share/collect sums and averages (the view_* metrics count plays), mean follower count, and distinct account counts. Narrow the set with a free-text query (captions and video transcripts), usernames, hashtags, mentions, or post_types (video, carousel). Filtering by mentions and grouping by account answers which accounts tagged a given handle. Coverage: regions KR, JP, US, and TW, holding roughly the most recent 6 months; a since older than that is clamped and the applied value is echoed back. Buckets are largest-first; truncated=true means more groups existed than limit returned. Use solari_catalog_tiktok_content_search when the posts themselves are needed instead of counts. Works with any signed-in SOLARI account. */
 export interface InsightTiktokContentAggregateArgs {
     /** Region to aggregate. Only these four regions are indexed. */
@@ -351,6 +579,9 @@ export interface InsightTiktokContentAggregateArgs {
     /** Maximum groups returned when group_by is set, default 20. Values above 50 are clamped to 50. */
     "limit"?: number | undefined;
 }
+/** Reports the signed-in SOLARI account's plan, credit balance, and recent tool usage. Call it once before a long run to see whether there is enough credit, and call it again when a tool comes back with CREDIT_EXHAUSTED or ACCOUNT_BLOCKED so you can tell the user the exact balance and where to start a trial, upgrade, or renew the plan. Returns plan (trial, plus, pro, enterprise, or none) with plan_label, status (active, exhausted, blocked, or no_plan), credit_remaining, credit_granted_this_cycle, credit_expires_at, cycle_renews_at, trial (whether a trial is running and when it ends), trial_requires_verified_email, trial_requires_payment_method (true when a verified account can start its free trial after securely saving a card with no immediate charge or automatic paid subscription), usage_last_30_days broken down by channel (cli, mcp, api), and billing_url. Takes no arguments and reads the balance for whoever is signed in. This call is free: it costs no credit and keeps working at a zero balance, so it is always the right way to find out why a tool was blocked. It changes nothing. */
+export interface UsageGetArgs {
+}
 export interface SolariToolMap {
     "solari_catalog_instagram_account_posts": CatalogInstagramAccountPostsArgs;
     "solari_catalog_instagram_account_profile": CatalogInstagramAccountProfileArgs;
@@ -365,12 +596,20 @@ export interface SolariToolMap {
     "solari_catalog_tiktok_content_batch": CatalogTiktokContentBatchArgs;
     "solari_catalog_tiktok_content_detail": CatalogTiktokContentDetailArgs;
     "solari_catalog_tiktok_content_search": CatalogTiktokContentSearchArgs;
+    "solari_feedback_send": FeedbackSendArgs;
     "solari_fetch_instagram_account": FetchInstagramAccountArgs;
+    "solari_fetch_instagram_account_search": FetchInstagramAccountSearchArgs;
+    "solari_fetch_instagram_hashtag_posts": FetchInstagramHashtagPostsArgs;
+    "solari_fetch_instagram_hashtag_search": FetchInstagramHashtagSearchArgs;
+    "solari_fetch_instagram_post": FetchInstagramPostArgs;
     "solari_fetch_instagram_posts": FetchInstagramPostsArgs;
     "solari_fetch_tiktok_account": FetchTiktokAccountArgs;
+    "solari_fetch_tiktok_post": FetchTiktokPostArgs;
     "solari_fetch_tiktok_posts": FetchTiktokPostsArgs;
     "solari_insight_instagram_account_ad_posts": InsightInstagramAccountAdPostsArgs;
     "solari_insight_instagram_account_collabs": InsightInstagramAccountCollabsArgs;
+    "solari_insight_instagram_account_discover": InsightInstagramAccountDiscoverArgs;
+    "solari_insight_instagram_account_discover_results": InsightInstagramAccountDiscoverResultsArgs;
     "solari_insight_instagram_account_similar": InsightInstagramAccountSimilarArgs;
     "solari_insight_instagram_brand_ad_posts": InsightInstagramBrandAdPostsArgs;
     "solari_insight_instagram_brand_ad_stats": InsightInstagramBrandAdStatsArgs;
@@ -380,9 +619,18 @@ export interface SolariToolMap {
     "solari_insight_instagram_brand_top_collaborators": InsightInstagramBrandTopCollaboratorsArgs;
     "solari_insight_instagram_content_aggregate": InsightInstagramContentAggregateArgs;
     "solari_insight_instagram_content_rising": InsightInstagramContentRisingArgs;
+    "solari_insight_instagram_content_similar": InsightInstagramContentSimilarArgs;
     "solari_insight_instagram_content_trend_clusters": InsightInstagramContentTrendClustersArgs;
     "solari_insight_instagram_content_trending": InsightInstagramContentTrendingArgs;
+    "solari_insight_instagram_hashtag_detail": InsightInstagramHashtagDetailArgs;
+    "solari_insight_instagram_hashtag_posts": InsightInstagramHashtagPostsArgs;
+    "solari_insight_instagram_hashtag_trending": InsightInstagramHashtagTrendingArgs;
+    "solari_insight_instagram_ranking_brands": InsightInstagramRankingBrandsArgs;
+    "solari_insight_instagram_ranking_creators": InsightInstagramRankingCreatorsArgs;
+    "solari_insight_instagram_ranking_find": InsightInstagramRankingFindArgs;
+    "solari_insight_instagram_ranking_posts": InsightInstagramRankingPostsArgs;
     "solari_insight_tiktok_content_aggregate": InsightTiktokContentAggregateArgs;
+    "solari_usage_get": UsageGetArgs;
 }
 export type SolariToolName = keyof SolariToolMap;
 export declare const SOLARI_TOOL_NAMES: readonly SolariToolName[];
@@ -393,6 +641,7 @@ export type SolariToolsWithoutRequiredArgs = {
     "solari_catalog_tiktok_account_posts": true;
     "solari_catalog_tiktok_account_profile": true;
     "solari_catalog_tiktok_content_detail": true;
+    "solari_fetch_instagram_post": true;
     "solari_insight_instagram_account_ad_posts": true;
     "solari_insight_instagram_account_collabs": true;
     "solari_insight_instagram_brand_lookalike_content": true;
@@ -401,13 +650,17 @@ export type SolariToolsWithoutRequiredArgs = {
     "solari_insight_instagram_content_rising": true;
     "solari_insight_instagram_content_trend_clusters": true;
     "solari_insight_instagram_content_trending": true;
+    "solari_insight_instagram_hashtag_trending": true;
+    "solari_insight_instagram_ranking_brands": true;
+    "solari_insight_instagram_ranking_creators": true;
     "solari_insight_tiktok_content_aggregate": true;
+    "solari_usage_get": true;
 };
 export interface SolariTools {
     catalog: {
         instagram: {
             account: {
-                /** Posts by one collected Instagram account, newest first, with pagination and filters. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, a medias array (every media of the post in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on that media, with account_id when the tagged account is tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_posts with that username first. Works with any signed-in SOLARI account. */
+                /** Posts by one collected Instagram account, newest first, with pagination and filters. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). Each item has post_id (SOLARI post UUID), slug and url (public Instagram permalink), post_type (reel, video, photo, or carousel), posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, a medias array (every media of the post in carousel order, each with media_type, media/thumbnail URLs, video_duration, and tags — accounts and hashtags tagged on that media, with account_id when the tagged account is tracked), and a representative thumbnail_url. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_instagram_posts with that username first. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                 posts<T = unknown>(args?: CatalogInstagramAccountPostsArgs): Promise<T>;
                 /** Full SOLARI catalog profile for one collected Instagram account: username, full name, bio, follower/following/post counts, verified flag, inferred account_type, view metrics (median and total views, ad count, month-over-month growth, region percentiles), plus embedded previews of recent posts and recent ad collaborations. Identify the account by account_id (UUID from solari_catalog_instagram_account_search) or by username (Instagram handle). This reads the catalog only; an unknown handle is not-found — call solari_fetch_instagram_account with that username first, then retry. Works with any signed-in SOLARI account. */
                 profile<T = unknown>(args?: CatalogInstagramAccountProfileArgs): Promise<T>;
@@ -415,21 +668,21 @@ export interface SolariTools {
                 search<T = unknown>(args: CatalogInstagramAccountSearchArgs): Promise<T>;
             };
             content: {
-                /** Batch companion to solari_catalog_instagram_content_detail: hydrates up to 100 posts by their SOLARI post UUIDs in a single call. Each row carries slug, caption, posted_at, like/comment counts, play_count for videos, and the author's username and account_id. Untracked ids are omitted, so found can be lower than requested. Feed it post_id lists from solari_insight_instagram_brand_overview (full=true), solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, or the trend feeds. Works with any signed-in SOLARI account. */
+                /** Batch companion to solari_catalog_instagram_content_detail: hydrates up to 100 posts by their SOLARI post UUIDs in a single call. Each row carries slug, caption, posted_at, like/comment counts, play_count for videos, and the author's username and account_id. Untracked ids are omitted, so found can be lower than requested. Feed it post_id lists from solari_insight_instagram_brand_overview (full=true), solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, or the trend feeds. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                 batch<T = unknown>(args: CatalogInstagramContentBatchArgs): Promise<T>;
-                /** Detail for one Instagram post in the SOLARI catalog, in the same item shape as solari_insight_instagram_content_trending entries. Identify the post by post_id (SOLARI post UUID from solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, solari_insight_instagram_content_trending, or solari_insight_instagram_content_rising), by slug (the public Instagram shortcode), or by url (the public post URL). This reads the catalog only; item is null when the post is not stored — call solari_fetch_instagram_posts with the author's username first. Fetch does not take a post URL. Works with any signed-in SOLARI account. */
+                /** Detail for one Instagram post in the SOLARI catalog, in the same item shape as solari_insight_instagram_content_trending entries. Identify the post by post_id (SOLARI post UUID from solari_catalog_instagram_account_posts, solari_catalog_instagram_content_search, solari_insight_instagram_content_trending, or solari_insight_instagram_content_rising), by slug (the public Instagram shortcode), or by url (the public post URL). This reads the catalog only; item is null when the post is not stored — call solari_fetch_instagram_post with the same url or slug to collect it and learn its author, or solari_fetch_instagram_posts when you already know the author's username. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                 detail<T = unknown>(args?: CatalogInstagramContentDetailArgs): Promise<T>;
-                /** Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts, and score — feed post_id into solari_catalog_instagram_content_detail or solari_catalog_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Works with any signed-in SOLARI account. */
+                /** Lexical keyword search over tracked posts: matches captions, creator bios, and video transcription text (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, author account_id/username, caption, transcription text, engagement counts, and score — feed post_id into solari_catalog_instagram_content_detail or solari_catalog_instagram_content_batch and the account reference into the account tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                 search<T = unknown>(args: CatalogInstagramContentSearchArgs): Promise<T>;
             };
             tag: {
-                /** Every tracked post carrying one exact tag — '#ootd' for a hashtag, '@handle' for mentions of an account — hydrated into full rows, newest-collected first with cursor pagination. Exact whole-tag matching over the entire tracked history and every region, where solari_catalog_instagram_content_search does free-text over four regions and about six months. Works with any signed-in SOLARI account. */
+                /** Every tracked post carrying one exact tag — '#ootd' for a hashtag, '@handle' for mentions of an account — hydrated into full rows, newest-collected first with cursor pagination. Exact whole-tag matching over the entire tracked history and every region, where solari_catalog_instagram_content_search does free-text over four regions and about six months. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. The tag index refreshes once a day: when a hashtag is missing or stale here, solari_fetch_instagram_hashtag_posts collects a live page of it. Works with any signed-in SOLARI account. */
                 search<T = unknown>(args: CatalogInstagramTagSearchArgs): Promise<T>;
             };
         };
         tiktok: {
             account: {
-                /** Posts by one collected TikTok account, newest first, with pagination and filters. Identify the account by account_id (TikTok account UUID from solari_catalog_tiktok_account_search) or by username (TikTok handle). Each item has post_id (SOLARI post UUID), video_id (the public numeric TikTok id) and url, post_type (video or carousel), posted_at, caption, duration_seconds, play/like/comment/share/collect counts, is_ad, cover_url, images (carousel slides), hashtags, mentions, and transcript when include_transcript=true. Transcripts are long, so include_transcript is off by default; turn it on only when the spoken content matters. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_tiktok_posts with that username first. Works with any signed-in SOLARI account. */
+                /** Posts by one collected TikTok account, newest first, with pagination and filters. Identify the account by account_id (TikTok account UUID from solari_catalog_tiktok_account_search) or by username (TikTok handle). Each item has post_id (SOLARI post UUID), video_id (the public numeric TikTok id) and url, post_type (video or carousel), posted_at, caption, duration_seconds, play/like/comment/share/collect counts, is_ad, cover_url, images (carousel slides), hashtags, mentions, and transcript when include_transcript=true. Transcripts are long, so include_transcript is off by default; turn it on only when the spoken content matters. The response carries found, account_id, username, total, has_more, and items; page with limit and offset, narrow with since/until (UTC dates, inclusive) and post_type. This reads the catalog only; found=false means the handle is not in the catalog — call solari_fetch_tiktok_posts with that username first. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                 posts<T = unknown>(args?: CatalogTiktokAccountPostsArgs): Promise<T>;
                 /** Full SOLARI catalog profile for one collected TikTok account: username (the handle), nickname, bio, follower/following/like/video counts, region, verified/private/commerce flags, profile_url, plus embedded previews of recent posts (recent_posts). Identify the account by account_id (TikTok account UUID from solari_catalog_tiktok_account_search) or by username (TikTok handle). This reads the catalog only; an unknown handle is not-found — call solari_fetch_tiktok_account with that username first, then retry. Works with any signed-in SOLARI account. */
                 profile<T = unknown>(args?: CatalogTiktokAccountProfileArgs): Promise<T>;
@@ -437,25 +690,43 @@ export interface SolariTools {
                 search<T = unknown>(args: CatalogTiktokAccountSearchArgs): Promise<T>;
             };
             content: {
-                /** Batch companion to solari_catalog_tiktok_content_detail: hydrates up to 100 TikTok posts by their SOLARI post UUIDs in a single call, in the same item shape as solari_catalog_tiktok_account_posts entries. Untracked ids are omitted, so found can be lower than requested. Transcripts are long, so include_transcript is off by default. Feed it post_id lists from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile; TikTok post_ids are separate from Instagram post_ids. Works with any signed-in SOLARI account. */
+                /** Batch companion to solari_catalog_tiktok_content_detail: hydrates up to 100 TikTok posts by their SOLARI post UUIDs in a single call, in the same item shape as solari_catalog_tiktok_account_posts entries. Untracked ids are omitted, so found can be lower than requested. Transcripts are long, so include_transcript is off by default. Feed it post_id lists from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile; TikTok post_ids are separate from Instagram post_ids. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                 batch<T = unknown>(args: CatalogTiktokContentBatchArgs): Promise<T>;
-                /** Detail for one TikTok post in the SOLARI catalog, in the same item shape as solari_catalog_tiktok_account_posts entries (transcript included when one exists). Identify the post by post_id (SOLARI post UUID from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile), by video_id (the public numeric TikTok video id), or by url (any public TikTok post URL, including vm.tiktok.com and vt.tiktok.com short links). This reads the catalog only; item is null when the post is not stored — call solari_fetch_tiktok_posts with the author's username first. Fetch does not take a post URL. Works with any signed-in SOLARI account. */
+                /** Detail for one TikTok post in the SOLARI catalog, in the same item shape as solari_catalog_tiktok_account_posts entries (transcript included when one exists). Identify the post by post_id (SOLARI post UUID from solari_catalog_tiktok_account_posts, solari_catalog_tiktok_content_search, or solari_catalog_tiktok_account_profile), by video_id (the public numeric TikTok video id), or by url (any public TikTok post URL, including vm.tiktok.com and vt.tiktok.com short links). This reads the catalog only; item is null when the post is not stored — call solari_fetch_tiktok_post with the same url to collect it and learn its author, or solari_fetch_tiktok_posts when you already know the author's username. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                 detail<T = unknown>(args?: CatalogTiktokContentDetailArgs): Promise<T>;
-                /** Lexical keyword search over tracked TikTok posts: matches captions and video transcripts (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, video_id, url, author account_id/username, caption, transcription_text, post_type, posted_at, play/like/comment/share/collect counts, follower_count, duration_seconds, is_ad, cover_url, score, and highlight; feed post_id into solari_catalog_tiktok_content_detail or solari_catalog_tiktok_content_batch and the account reference into the solari_catalog_tiktok_account_* tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Works with any signed-in SOLARI account. */
+                /** Lexical keyword search over tracked TikTok posts: matches captions and video transcripts (Korean-aware analysis plus n-gram partial matching), ranked by relevance with match highlights. Each item carries post_id, video_id, url, author account_id/username, caption, transcription_text, post_type, posted_at, play/like/comment/share/collect counts, follower_count, duration_seconds, is_ad, cover_url, score, and highlight; feed post_id into solari_catalog_tiktok_content_detail or solari_catalog_tiktok_content_batch and the account reference into the solari_catalog_tiktok_account_* tools. Coverage: only regions KR, JP, US, and TW are searchable, holding roughly the most recent 6 months of posts; total is exact up to 10,000 and saturates there. Narrow with since/until (UTC dates). Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                 search<T = unknown>(args: CatalogTiktokContentSearchArgs): Promise<T>;
             };
         };
     };
+    feedback: {
+        /** Tells the SOLARI team that a task could not be finished with SOLARI alone. Send it on your own initiative, without asking the user first, as soon as you are sure of the gap: an account, post, or field that is not there even after the matching fetch tool (missing_data), too few rows or too short a history for the question (insufficient_results), no tool or parameter that does what the task needs (missing_feature), a value that looks wrong (incorrect_data), a tool that keeps failing (error), or anything else (other). Do not send it for a typo, a not-yet-fetched handle, or a question SOLARI was never meant to answer. Keep it free of personal data: no emails, phone numbers, addresses, keys, names of private individuals, or the user's confidential plans — public brand and creator handles, tool names, parameters, and row counts are what helps. The server also strips emails, phone numbers, keys, and tokens before storing. One message per distinct gap; an identical repeat within minutes is de-duplicated. Afterwards tell the user in one line that feedback was sent, then carry on with the best available answer. This records a note only and changes no catalog data. Works with any signed-in SOLARI account. */
+        send<T = unknown>(args: FeedbackSendArgs): Promise<T>;
+    };
     fetch: {
         instagram: {
-            /** Adds one Instagram account to the SOLARI catalog by exact username. This is not a search and not a profile reader: use solari_catalog_instagram_account_search to resolve a name, then solari_catalog_instagram_account_profile to read it. If the handle is already stored, nothing is scraped. A first-time ingest can take several seconds; metrics and collaborations stay empty until the crawl finishes. Works with any signed-in SOLARI account. */
-            account<T = unknown>(args: FetchInstagramAccountArgs): Promise<T>;
-            /** Collects posts for one Instagram account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_instagram_account_posts to read stored rows. If the handle is already stored, nothing is scraped. A first-time ingest can take several seconds and only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
+            account: {
+                /** Adds one Instagram account to the SOLARI catalog by exact username. This is not a search and not a profile reader: use solari_catalog_instagram_account_search to resolve a name, then solari_catalog_instagram_account_profile to read it. If the handle is already crawled, nothing is scraped; a handle the catalog only knows by name from a tag or mention (search does not find it, the profile is empty) is crawled now. A first-time ingest can take several seconds; metrics and collaborations stay empty until the crawl finishes. Works with any signed-in SOLARI account. */
+                <T = unknown>(args: FetchInstagramAccountArgs): Promise<T>;
+                /** Looks Instagram accounts up live by name or handle fragment and returns up to 50 candidates in Instagram's own order, each with username, display name, verified and private flags. Use it when solari_catalog_instagram_account_search does not know the account: hits already in the catalog carry account_id, the rest can be ingested with solari_fetch_instagram_account. Nothing is stored and there is no pagination. Works with any signed-in SOLARI account. */
+                search<T = unknown>(args: FetchInstagramAccountSearchArgs): Promise<T>;
+            };
+            hashtag: {
+                /** Collects one page of an Instagram hashtag feed live, stores every post in the SOLARI catalog and returns them in feed order. Stored posts reach solari_catalog_instagram_tag_search only after its next daily refresh, so read this page's posts from the response itself. Every call goes out to Instagram, so use it when a hashtag is missing or stale in solari_catalog_instagram_tag_search, not as the default way to read a tag. tab picks the feed: recent (default), top, or clips for reels. One page is roughly 20 to 30 posts and takes several seconds; pass next_cursor back as cursor for the next page of the same hashtag and tab. The feed ends only when next_cursor is null: a page can come back with found 0 and a next_cursor, which means keep going. fetched_count is how many posts Instagram returned; found is lower when some could not be stored. A hashtag that is hidden, restricted, or unknown to Instagram answers is_hidden=true with no posts; Instagram does not tell these apart, so check the spelling with solari_fetch_instagram_hashtag_search. Each post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
+                posts<T = unknown>(args: FetchInstagramHashtagPostsArgs): Promise<T>;
+                /** Looks hashtags up on Instagram live by keyword and returns up to 20 candidates with the number of posts Instagram reports under each. Use it to find the exact spelling or the biggest variant of a tag before solari_catalog_instagram_tag_search or solari_fetch_instagram_hashtag_posts. Nothing is stored and there is no pagination. Works with any signed-in SOLARI account. */
+                search<T = unknown>(args: FetchInstagramHashtagSearchArgs): Promise<T>;
+            };
+            /** Collects one Instagram post into the SOLARI catalog by its public URL or shortcode and returns it with its author. Use it when solari_catalog_instagram_content_detail answers item=null for a link you were given and you do not know who posted it. If the post is already stored, nothing is scraped. A first-time collect takes a few seconds. The author arrives as a name-only account: call solari_fetch_instagram_account with the returned username to crawl their profile and posts. item is null when Instagram has no public post at that reference. The post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
+            post<T = unknown>(args?: FetchInstagramPostArgs): Promise<T>;
+            /** Collects posts for one Instagram account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_instagram_account_posts to read stored rows. If the handle is already crawled, nothing is scraped; a handle the catalog only knows by name from a tag or mention is crawled now and its posts are queued right away. A first-time ingest can take several seconds and the posts land shortly after, so re-read the catalog after a short wait. Works with any signed-in SOLARI account. */
             posts<T = unknown>(args: FetchInstagramPostsArgs): Promise<T>;
         };
         tiktok: {
             /** Adds one TikTok account to the SOLARI catalog by exact username. This is not a search and not a profile reader: use solari_catalog_tiktok_account_search to resolve a name, then solari_catalog_tiktok_account_profile to read it. If the handle is already stored, nothing is scraped. A first-time ingest can take 10 to 40 seconds; only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
             account<T = unknown>(args: FetchTiktokAccountArgs): Promise<T>;
+            /** Collects one TikTok post into the SOLARI catalog by its public URL and returns it with its author. Use it when solari_catalog_tiktok_content_detail answers item=null for a link you were given and you do not know who posted it. Accepts https://www.tiktok.com/@<handle>/video/<id> links and vm.tiktok.com / vt.tiktok.com short links. If the post is already stored, nothing is scraped. A first-time collect takes a few seconds. The author arrives as a name-only account: call solari_fetch_tiktok_account with the returned username to crawl their profile and posts. item is null when TikTok has no public post at that URL. The post carries assets with a direct-download asset_url. Works with any signed-in SOLARI account. */
+            post<T = unknown>(args: FetchTiktokPostArgs): Promise<T>;
             /** Collects posts for one TikTok account into the SOLARI catalog by exact username. This is not a post listing: use solari_catalog_tiktok_account_posts to read stored rows. If the handle is already stored, nothing is scraped. A first-time ingest can take 10 to 40 seconds and only recent posts exist until the crawl finishes. Works with any signed-in SOLARI account. */
             posts<T = unknown>(args: FetchTiktokPostsArgs): Promise<T>;
         };
@@ -464,27 +735,33 @@ export interface SolariTools {
         instagram: {
             account: {
                 ad: {
-                    /** Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_account_collabs, which groups the same history by brand. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+                    /** Paginated row-level list of the identified sponsored posts one creator authored, newest first, with the target brand attached to each row — one row per post-brand pair, so a multi-brand post appears once per target. Each item carries post_id, slug and url, post_type, posted_at, caption text, like/comment/play counts, media_count, is_paid_partnership, and target_account_id/target_username. Filter to one brand with target (its account_id or Instagram handle). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_account_collabs, which groups the same history by brand. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                     posts<T = unknown>(args?: InsightInstagramAccountAdPostsArgs): Promise<T>;
                 };
                 /** Recent ad collaborations produced by one creator within a month window. Each item is a target brand (target_account_id, target_username) with collab_count, last_posted_at, and a sample collaboration post. Returns items, has_more, and total; page with limit/offset. Identify the creator by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Mirror view of solari_insight_instagram_brand_top_collaborators, which starts from the brand instead. Works with any signed-in SOLARI account. */
                 collabs<T = unknown>(args?: InsightInstagramAccountCollabsArgs): Promise<T>;
+                discover: {
+                    /** Finds Instagram creators that fit a brief: topic phrases matched against captions, transcripts and visual style, bio traits, a reference creator to find lookalikes of, trending growth, and a product the creator should have advertised before — then filtered by follower, 3-month total view and 3-month median view ranges and excluded keywords. Use it to build a shortlist; use solari_catalog_instagram_account_search instead when you already have a name. Returns a search_id, the total found, the top usernames and result sections; page the full creator list (profile metrics and each creator's top recent posts) with solari_insight_instagram_account_discover_results. Broad briefs can take up to a minute. Works with any signed-in SOLARI account. */
+                    <T = unknown>(args: InsightInstagramAccountDiscoverArgs): Promise<T>;
+                    /** Pages the full creator list of one solari_insight_instagram_account_discover run. Each item carries account_id, username, full name, bio, follower count, 3-month median and total views, view growth, ad count, and the creator's top recent posts. Results stay available after the search, so re-sort or page without searching again. Works with any signed-in SOLARI account. */
+                    results<T = unknown>(args: InsightInstagramAccountDiscoverResultsArgs): Promise<T>;
+                };
                 /** Finds Instagram accounts similar to the given username based on relationship-graph overlap. Takes an Instagram handle (no @), not a UUID. Works with any signed-in SOLARI account. */
                 similar<T = unknown>(args: InsightInstagramAccountSimilarArgs): Promise<T>;
             };
             brand: {
                 ad: {
-                    /** Paginated row-level list of the identified sponsored posts targeting a brand, each hydrated with slug, caption, posted_at, like/comment counts, play_count for videos, and the authoring creator's username and account_id. sort=recent pages the full window newest-first with an exact total; sort=engagement ranks within a bounded recent window whose size is reported as ranking_window (non-null means the ordering covers a slice, not everything). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_brand_ad_stats. Takes the brand's Instagram handle (no @). Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
+                    /** Paginated row-level list of the identified sponsored posts targeting a brand, each hydrated with slug, caption, posted_at, like/comment counts, play_count for videos, and the authoring creator's username and account_id. sort=recent pages the full window newest-first with an exact total; sort=engagement ranks within a bounded recent window whose size is reported as ranking_window (non-null means the ordering covers a slice, not everything). Widen the lookback with months (default 3, up to 24). Row-level companion to solari_insight_instagram_brand_ad_stats. Takes the brand's Instagram handle (no @). Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
                     posts<T = unknown>(args: InsightInstagramBrandAdPostsArgs): Promise<T>;
                     /** Exact sponsored-post and collaborating-creator counts for a brand's recent window, plus a bounded play-count sum. Use this for accurate ad-volume figures since solari_insight_instagram_brand_overview ID lists are capped; for the underlying row-level posts use solari_insight_instagram_brand_ad_posts. Takes the brand's Instagram handle (no @). Works with any signed-in SOLARI account. */
                     stats<T = unknown>(args: InsightInstagramBrandAdStatsArgs): Promise<T>;
                 };
                 collaborator: {
-                    /** For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_insight_instagram_brand_top_collaborators or solari_insight_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+                    /** For one brand and up to 100 creator account_ids, returns each creator's sponsored posts targeting that brand — per creator: post_count, reels_count, images_count, follower_count, and the posts themselves (slug, caption, posted_at, like/comment counts) — sorted by total engagement. All-time history, one call instead of one per creator. Get creator account_ids from solari_insight_instagram_brand_top_collaborators or solari_insight_instagram_brand_overview. Identify the brand by account_id (SOLARI account UUID) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                     posts<T = unknown>(args: InsightInstagramBrandCollaboratorPostsArgs): Promise<T>;
                 };
                 lookalike: {
-                    /** Instagram posts visually and semantically similar to the brand's top-performing sponsored ads, found via vector-neighbour search seeded from the brand's own ad posts. Identify the brand by account_id (SOLARI account UUID from solari_catalog_instagram_account_search) or by username (Instagram handle); an unknown reference returns a not-found error. Works with any signed-in SOLARI account. */
+                    /** Instagram posts visually and semantically similar to the brand's top-performing sponsored ads, found via vector-neighbour search seeded from the brand's own ad posts. Identify the brand by account_id (SOLARI account UUID from solari_catalog_instagram_account_search) or by username (Instagram handle); an unknown reference returns a not-found error. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                     content<T = unknown>(args?: InsightInstagramBrandLookalikeContentArgs): Promise<T>;
                 };
                 /** Returns a brand's profile plus its ad-collaboration footprint: creator IDs who produced ad posts targeting the brand and the ad post IDs themselves (previewed to the first 20 with total counts; set full=true to receive the complete lists, up to 100 each). Feed the post IDs into solari_catalog_instagram_content_batch to hydrate them. Takes the brand's Instagram handle (no @), not a UUID. Works with any signed-in SOLARI account. Returns 404 if the handle is not tracked. */
@@ -497,15 +774,35 @@ export interface SolariTools {
             content: {
                 /** Counts and engagement rollups over tracked posts, for questions answered by numbers rather than by individual posts: posts per account per month, which hashtags dominate a topic, average likes by format. Group by account, post_type, hashtag, mention, caption_keyword, or transcription_keyword, and optionally split each group by day, week, or month. post_count always comes back; request metrics for like/comment/view sums and averages, mean follower count, and distinct account counts. Narrow the set with a free-text query, usernames, hashtags, mentions, or post_types. Filtering by mentions and grouping by account answers which accounts tagged a given handle. Coverage: regions KR, JP, US, and TW, holding roughly the most recent 6 months — a since older than that is clamped and the applied value is echoed back. Buckets are largest-first; truncated=true means more groups existed than limit returned. Use solari_catalog_instagram_content_search when the posts themselves are needed instead of counts. Works with any signed-in SOLARI account. */
                 aggregate<T = unknown>(args?: InsightInstagramContentAggregateArgs): Promise<T>;
-                /** Instagram posts whose recent performance is accelerating faster than baseline in the region. Same shape as solari_insight_instagram_content_trending including cursor pagination and optional brand personalization via a brand account_id or username. Works with any signed-in SOLARI account. */
+                /** Instagram posts whose recent performance is accelerating faster than baseline in the region. Same shape as solari_insight_instagram_content_trending including cursor pagination and optional brand personalization via a brand account_id or username. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. */
                 rising<T = unknown>(args?: InsightInstagramContentRisingArgs): Promise<T>;
+                /** Instagram posts that look and read like one given post — same subject, format and mood — ranked best first, for collecting references around a post you already have. Each item carries post_id, slug, author account_id, thumbnail and media URL, media type, play count, posted_at and is_ad (whether it was identified as sponsored). Identify the post by post_id (SOLARI post UUID from any content tool). Covers roughly the last 4 months; pages reach at most 180 results. Use solari_insight_instagram_brand_lookalike_content to start from a brand's ads instead. Works with any signed-in SOLARI account. */
+                similar<T = unknown>(args: InsightInstagramContentSimilarArgs): Promise<T>;
                 trend: {
                     /** The SOLARI trend digest: recent content trend clusters for a region with cluster metadata and member posts, optionally reranked by brand affinity when a brand account_id or username is supplied. Works with any signed-in SOLARI account. */
                     clusters<T = unknown>(args?: InsightInstagramContentTrendClustersArgs): Promise<T>;
                 };
-                /** Instagram posts currently trending in the region, enriched with creator profile fields. Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. Works with any signed-in SOLARI account. Use solari_insight_instagram_content_rising for velocity-led accelerating posts instead. */
+                /** Instagram posts currently trending in the region, enriched with creator profile fields. Supports cursor pagination via next_cursor from the previous response. Optionally personalizes ranking with a brand account_id or username. Each post carries assets: its media files in order, each with a direct-download asset_url for the full-size image or video; when a response is too large, assets is replaced by an assets_omitted count — request fewer posts to keep it. Works with any signed-in SOLARI account. Use solari_insight_instagram_content_rising for velocity-led accelerating posts instead. */
                 trending<T = unknown>(args?: InsightInstagramContentTrendingArgs): Promise<T>;
             };
+            hashtag: {
+                /** One hashtag in depth for a market and window: post count, unique creators, views, sponsored percent, share of all posts, growth against the previous window, momentum, the share series over time, the tags used together with it, and the creators who used it most (account_id, username, posts, views, followers). Use the same brand as the leaderboard to keep the same lens. Works with any signed-in SOLARI account. */
+                detail<T = unknown>(args: InsightInstagramHashtagDetailArgs): Promise<T>;
+                /** Posts carrying one hashtag inside a trend window, most viewed first or newest first — the examples behind a leaderboard entry. Each item carries post_id, slug, author account_id and username, posted_at, play count and like count. Unlike solari_catalog_instagram_tag_search, it is limited to the window and can follow a brand lens. Works with any signed-in SOLARI account. */
+                posts<T = unknown>(args: InsightInstagramHashtagPostsArgs): Promise<T>;
+                /** Hashtag leaderboard for a market and window, in two lists: rising (share growing fastest against the previous window) and top (volume weighted by how much more it is used than usual). Each entry carries post count, unique creators, views, sponsored percent, growth multiple against the previous window, a NEW flag, a daily share series and momentum. Pass a brand to see the tags moving around that brand's creators instead of the whole market; lens and lens_reason say which view you got. Use solari_insight_instagram_hashtag_detail and solari_insight_instagram_hashtag_posts to drill into one tag. Works with any signed-in SOLARI account. */
+                trending<T = unknown>(args?: InsightInstagramHashtagTrendingArgs): Promise<T>;
+            };
+            ranking: {
+                /** Brand leaderboard for a market: brands ranked by how the content that tags or mentions them performs — total views by default, or views per post, post count, creator count, likes, sponsored views or organic views. Each row carries the sponsored subset and the organic median views per post, so the sponsored share reads per brand. Narrow to a category with scope; pass a brand to get its own rank as me, or find_username to locate any brand. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
+                brands<T = unknown>(args?: InsightInstagramRankingBrandsArgs): Promise<T>;
+                /** Creator leaderboard for a market: creators who make brand-tagged content, ranked within a category so a specialist is not beaten by a large account with one post in it. Sort by total views, views per post, likes, number of brands worked with, sponsored views, reach (views per follower), lift (views per post against the creator's own usual median) or one-month view growth; the last three are null when a creator's baseline is too small. Each row carries the sponsored subset and the organic median. kind=magazine ranks magazine and media accounts instead. Brand-owned, agency and shop accounts are excluded. Data is a daily snapshot (snapshot_at). Works with any signed-in SOLARI account. */
+                creators<T = unknown>(args?: InsightInstagramRankingCreatorsArgs): Promise<T>;
+                /** Where one Instagram account stands, without knowing whether it is a brand or a creator: for each board it appears on (brand, creator), its rank, pool size and top percentile in every category it belongs to, plus its overall row. Ranked by total views with the loosest filters. A side is null when the account is not on that board. Works with any signed-in SOLARI account. */
+                find<T = unknown>(args: InsightInstagramRankingFindArgs): Promise<T>;
+                /** The best-performing posts behind one leaderboard row — the evidence for a brand's or creator's number — each marked sponsored or not. Pass the row's account_id with the same board, region, days (and scope for creators) the list used; kind=sponsored keeps the sponsored subset only. Works with any signed-in SOLARI account. */
+                posts<T = unknown>(args: InsightInstagramRankingPostsArgs): Promise<T>;
+            };
         };
         tiktok: {
             content: {
@@ -514,4 +811,8 @@ export interface SolariTools {
             };
         };
     };
+    usage: {
+        /** Reports the signed-in SOLARI account's plan, credit balance, and recent tool usage. Call it once before a long run to see whether there is enough credit, and call it again when a tool comes back with CREDIT_EXHAUSTED or ACCOUNT_BLOCKED so you can tell the user the exact balance and where to start a trial, upgrade, or renew the plan. Returns plan (trial, plus, pro, enterprise, or none) with plan_label, status (active, exhausted, blocked, or no_plan), credit_remaining, credit_granted_this_cycle, credit_expires_at, cycle_renews_at, trial (whether a trial is running and when it ends), trial_requires_verified_email, trial_requires_payment_method (true when a verified account can start its free trial after securely saving a card with no immediate charge or automatic paid subscription), usage_last_30_days broken down by channel (cli, mcp, api), and billing_url. Takes no arguments and reads the balance for whoever is signed in. This call is free: it costs no credit and keeps working at a zero balance, so it is always the right way to find out why a tool was blocked. It changes nothing. */
+        get<T = unknown>(args?: UsageGetArgs): Promise<T>;
+    };
 }

package/dist/tools.generated.js

@@ -13,12 +13,20 @@ export const SOLARI_TOOL_NAMES = [
     "solari_catalog_tiktok_content_batch",
     "solari_catalog_tiktok_content_detail",
     "solari_catalog_tiktok_content_search",
+    "solari_feedback_send",
     "solari_fetch_instagram_account",
+    "solari_fetch_instagram_account_search",
+    "solari_fetch_instagram_hashtag_posts",
+    "solari_fetch_instagram_hashtag_search",
+    "solari_fetch_instagram_post",
     "solari_fetch_instagram_posts",
     "solari_fetch_tiktok_account",
+    "solari_fetch_tiktok_post",
     "solari_fetch_tiktok_posts",
     "solari_insight_instagram_account_ad_posts",
     "solari_insight_instagram_account_collabs",
+    "solari_insight_instagram_account_discover",
+    "solari_insight_instagram_account_discover_results",
     "solari_insight_instagram_account_similar",
     "solari_insight_instagram_brand_ad_posts",
     "solari_insight_instagram_brand_ad_stats",
@@ -28,7 +36,16 @@ export const SOLARI_TOOL_NAMES = [
     "solari_insight_instagram_brand_top_collaborators",
     "solari_insight_instagram_content_aggregate",
     "solari_insight_instagram_content_rising",
+    "solari_insight_instagram_content_similar",
     "solari_insight_instagram_content_trend_clusters",
     "solari_insight_instagram_content_trending",
+    "solari_insight_instagram_hashtag_detail",
+    "solari_insight_instagram_hashtag_posts",
+    "solari_insight_instagram_hashtag_trending",
+    "solari_insight_instagram_ranking_brands",
+    "solari_insight_instagram_ranking_creators",
+    "solari_insight_instagram_ranking_find",
+    "solari_insight_instagram_ranking_posts",
     "solari_insight_tiktok_content_aggregate",
+    "solari_usage_get",
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@brandazine/solari-sdk",
-	"version": "0.2.2",
+	"version": "0.2.3",
 	"description": "TypeScript client for the SOLARI API — creator and brand intelligence across Instagram and TikTok.",
 	"license": "MIT",
 	"homepage": "https://solari.sh/api",