@brandazine/solari-sdk 0.2.9 → 0.2.11

package/README.md

@@ -19,7 +19,9 @@ const thread = await solari.tools.fetch.threads.post({ url: "https://www.threads
 const tools = await solari.listTools();
 ```
 
-Threads is fetch-only: `solari.tools.fetch.threads.account.search({ query })` finds handles by name and `.post.search({ query })` returns Threads' top posts for a keyword (both live on every call, one page, not cached); `.account({ username })`, `.posts({ username, limit })`, and `.post({ url })` (or `{ code }`) read the profile, its newest posts, or one post with its first replies straight from the response. A first collection takes 5 to 30 seconds; repeat calls within an hour return the stored copy unless `refresh: true`.
+For Threads, `solari.tools.fetch.threads.account.search({ query })` finds handles by name and `.post.search({ query })` returns Threads' top posts for a keyword (both live on every call, one page, not cached); `.account({ username })`, `.posts({ username, limit })`, and `.post({ url })` (or `{ code }`) read the profile, its newest posts, or one post with its first replies straight from the response. A first collection takes 5 to 30 seconds; repeat calls within an hour return the stored copy unless `refresh: true`.
+
+For TikTok live search, `solari.tools.fetch.tiktok.account.search({ query })` finds accounts by name and `.post.search({ query })` finds videos by keyword, in TikTok's own order (live on every call, not cached, nothing stored). When `has_more` is true, pass `next_cursor` back as `cursor` with the same query for the next page. Account hits carry `account_id` when already in the catalog, else `.account({ username })` adds one; `.post({ url })` collects and stores a video hit.
 
 Follower and engagement trends: `solari.tools.catalog.instagram.account.history({ username, since })` returns follower, following, and post counts at each collection (`captured_at`) plus `current.collected_at`, and `solari.tools.catalog.instagram.content.history({ username, posted_since })` (or `{ post_ids }`, `{ slugs }`, `{ urls }`) returns each post's like, comment, play, and reshare counts over time. One point per UTC day by default (`granularity: "all"` for every collection); gaps between points are normal.
 

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.9";
+export declare const SDK_VERSION = "0.2.11";
 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.9";
+export const SDK_VERSION = "0.2.11";
 export const TOKEN_ENV = "SOLARI_TOKEN";
 const DEFAULT_TIMEOUT_MS = 150_000;
 export class SolariError extends Error {

package/dist/tools.generated.d.ts

@@ -232,21 +232,21 @@ export interface FetchInstagramPostsArgs {
     /** Instagram handle, with or without a leading @. */
     "username": string;
 }
-/** Reads one Meta Threads account by exact username and returns its profile: display name, biography, follower count, verified and private flags, bio links, profile picture and URL. Threads is fetch-only in SOLARI: there are no catalog or insight tools for it, so call this directly with the exact handle and read the answer from the response; when you only know a name, find the handle with solari_fetch_threads_account_search first. A handle SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds, and fetched_on_demand=true marks that case; repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned; collected_at says when. Media URLs right after a collection may be temporary, so read them promptly. Nothing is enrolled in ongoing tracking. A handle with no Threads profile answers a not-found error. Works with any signed-in SOLARI account. */
+/** Reads one Meta Threads account by exact username and returns its profile: display name, biography, follower count, verified and private flags, bio links, profile picture and URL. When you only know a name, find the handle with solari_fetch_threads_account_search first. A handle SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds, and fetched_on_demand=true marks that case; repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned; collected_at says when. Media URLs right after a collection may be temporary, so read them promptly. Nothing is enrolled in ongoing tracking. A handle with no Threads profile answers a not-found error. Works with any signed-in SOLARI account. */
 export interface FetchThreadsAccountArgs {
     /** Threads handle, with or without a leading @. */
     "username": string;
     /** true collects the profile again even when a copy from the last hour exists. Default false. */
     "refresh"?: boolean | undefined;
 }
-/** Looks Meta Threads accounts up live by name or handle fragment and returns thin hits in Threads' own order: username, display name, profile picture, verified flag and URL (limit up to 20, default 10). Threads is fetch-only in SOLARI: there are no catalog or insight tools for it, and this is its account search, so use it when you know a name but not the exact handle. Official accounts may not rank first, so check the hits before choosing one. Hits carry no account_id and nothing is stored; call solari_fetch_threads_account with the chosen username for the full profile (follower count, biography, bio links) and solari_fetch_threads_posts for its posts. Every call asks Threads live, takes a second or two, is not cached, and costs 1 credit. An empty items list means Threads matched nothing. Works with any signed-in SOLARI account. */
+/** Looks Meta Threads accounts up live by name or handle fragment and returns thin hits in Threads' own order: username, display name, profile picture, verified flag and URL (limit up to 20, default 10). Use it when you know a name but not the exact handle. Official accounts may not rank first, so check the hits before choosing one. Hits carry no account_id and nothing is stored; call solari_fetch_threads_account with the chosen username for the full profile (follower count, biography, bio links) and solari_fetch_threads_posts for its posts. Every call asks Threads live, takes a second or two, and is not cached. An empty items list means Threads matched nothing. Works with any signed-in SOLARI account. */
 export interface FetchThreadsAccountSearchArgs {
     /** Name or handle fragment, with or without a leading @. */
     "query": string;
     /** Maximum hits to return, default 10. Values above 20 are clamped to 20. */
     "limit"?: number | undefined;
 }
-/** Reads one Meta Threads post by its public URL or permalink code and returns it with its author and the first batch of direct replies (replies_limit, default 20, max 50, most liked first; 0 skips them). Accepts https://www.threads.com/@<handle>/post/<code> (threads.net too) as url, or the bare code. Threads is fetch-only in SOLARI: there are no catalog or insight tools for it, so call this directly and read the post from the response. A post SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds (fetched_on_demand=true); repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned. Replies are the first batch only, so the post's reply_count can exceed the replies returned. Media URLs right after a collection may be temporary, so read them promptly; assets carry a direct-download asset_url. A reference with no public post answers a not-found error. Run next with the returned username to read the author's profile and posts. Works with any signed-in SOLARI account. */
+/** Reads one Meta Threads post by its public URL or permalink code and returns it with its author and the first batch of direct replies (replies_limit, default 20, max 50, most liked first; 0 skips them). Accepts https://www.threads.com/@<handle>/post/<code> (threads.net too) as url, or the bare code. A post SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds (fetched_on_demand=true); repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned. Replies are the first batch only, so the post's reply_count can exceed the replies returned. Media URLs right after a collection may be temporary, so read them promptly; assets carry a direct-download asset_url. A reference with no public post answers a not-found error. Run next with the returned username to read the author's profile and posts. Works with any signed-in SOLARI account. */
 export interface FetchThreadsPostArgs {
     /** Public Threads post URL such as https://www.threads.com/@<handle>/post/<code>. Provide this or code, not both. */
     "url"?: string | undefined;
@@ -257,14 +257,14 @@ export interface FetchThreadsPostArgs {
     /** true collects the post and its replies again even when a copy from the last hour exists. Default false. */
     "refresh"?: boolean | undefined;
 }
-/** Searches Meta Threads live for posts matching a keyword and returns Threads' top results: one page of about 20 posts (limit up to 25) in Threads' own relevance order, each with full post fields (text, hashtags, mentions, like, reply, repost and quote counts, author username, url, and assets with a direct-download asset_url). Threads is fetch-only in SOLARI: there are no catalog or insight tools for it, and this is its keyword search. Only Threads' top tab is available: there is no recent tab and no further page, so calling again with the same query returns the same page, and results may include loosely related posts. The matching posts are collected and stored, so solari_fetch_threads_post can read any of them with its replies and solari_fetch_threads_account can read an author. Every call asks Threads live, takes a few seconds, is not cached, and costs 1 credit. An empty items list means Threads found no public post for the keyword. Works with any signed-in SOLARI account. */
+/** Searches Meta Threads live for posts matching a keyword and returns Threads' top results: one page of about 20 posts (limit up to 25) in Threads' own relevance order, each with full post fields (text, hashtags, mentions, like, reply, repost and quote counts, author username, url, and assets with a direct-download asset_url). Only Threads' top tab is available: there is no recent tab and no further page, so calling again with the same query returns the same page, and results may include loosely related posts. The matching posts are collected and stored, so solari_fetch_threads_post can read any of them with its replies and solari_fetch_threads_account can read an author. Every call asks Threads live, takes a few seconds, and is not cached. An empty items list means Threads found no public post for the keyword. Works with any signed-in SOLARI account. */
 export interface FetchThreadsPostSearchArgs {
     /** Keyword or phrase to search Threads posts for. */
     "query": string;
     /** Maximum posts to return from the one result page, default 20. Values above 25 are clamped to 25. */
     "limit"?: number | undefined;
 }
-/** Reads the recent top-level posts of one Meta Threads account by exact username, newest first, together with its profile. limit picks how many (default 12, max 25); each post carries text, hashtags, mentions, links, like, reply, repost and quote counts, the quoted post, and assets with a direct-download asset_url. Threads is fetch-only in SOLARI: there are no catalog or insight tools for it, so call this directly with the handle and read the posts from the response. A handle SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds (fetched_on_demand=true); repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned. Media URLs right after a collection may be temporary, so read them promptly. A private account answers its profile with posts empty. The account's own replies are not listed: solari_fetch_threads_post reads one post with its replies. A handle with no Threads profile answers a not-found error. Works with any signed-in SOLARI account. */
+/** Reads the recent top-level posts of one Meta Threads account by exact username, newest first, together with its profile. limit picks how many (default 12, max 25); each post carries text, hashtags, mentions, links, like, reply, repost and quote counts, the quoted post, and assets with a direct-download asset_url. A handle SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds (fetched_on_demand=true); repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned. Media URLs right after a collection may be temporary, so read them promptly. A private account answers its profile with posts empty. The account's own replies are not listed: solari_fetch_threads_post reads one post with its replies. A handle with no Threads profile answers a not-found error. Works with any signed-in SOLARI account. */
 export interface FetchThreadsPostsArgs {
     /** Threads handle, with or without a leading @. */
     "username": string;
@@ -278,11 +278,29 @@ export interface FetchTiktokAccountArgs {
     /** TikTok handle, with or without a leading @. */
     "username": string;
 }
+/** Looks TikTok accounts up live by name or handle fragment and returns thin hits in TikTok's own order: username, nickname, bio, verified flag, follower count, profile picture and URL (limit up to 30, default 10). Use it when solari_catalog_tiktok_account_search does not know the account, or when you know a name but not the exact handle. Hits already in the SOLARI catalog carry account_id for the solari_catalog_tiktok_* tools; for the rest account_id is null, so call solari_fetch_tiktok_account with the chosen username to add it. When has_more is true, pass next_cursor back as cursor with the same query for the next page; next_cursor is null on the last page. Nothing is stored. Every call asks TikTok live, takes a few seconds, and is not cached. An empty items list means TikTok matched nothing. Works with any signed-in SOLARI account. */
+export interface FetchTiktokAccountSearchArgs {
+    /** Name or handle fragment, with or without a leading @. */
+    "query": string;
+    /** Maximum hits to return, default 10. Values above 30 are clamped to 30. */
+    "limit"?: number | undefined;
+    /** next_cursor from the previous response for the same query. Omit for the first page. */
+    "cursor"?: string | undefined;
+}
 /** 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;
 }
+/** Searches TikTok live for videos matching a keyword and returns thin hits in TikTok's own relevance order: video_id, url, author username, caption, posted_at, play, like, comment and share counts, duration and cover image (limit up to 30, default 20). Use it when you want what people post on TikTok about a topic, brand or phrase and have no handle to start from. Hits are not stored and carry no post_id; call solari_fetch_tiktok_post with a hit's url to collect and store the full post with its author. When has_more is true, pass next_cursor back as cursor with the same query for the next page; next_cursor is null on the last page. Every call asks TikTok live, takes a few seconds, and is not cached. An empty items list, with a note, means TikTok found no public video for the keyword. Works with any signed-in SOLARI account. */
+export interface FetchTiktokPostSearchArgs {
+    /** Keyword or phrase to search TikTok videos for. */
+    "query": string;
+    /** Maximum videos to return, default 20. Values above 30 are clamped to 30. */
+    "limit"?: number | undefined;
+    /** next_cursor from the previous response for the same query. Omit for the first page. */
+    "cursor"?: string | undefined;
+}
 /** 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 @. */
@@ -690,7 +708,9 @@ export interface SolariToolMap {
     "solari_fetch_threads_post_search": FetchThreadsPostSearchArgs;
     "solari_fetch_threads_posts": FetchThreadsPostsArgs;
     "solari_fetch_tiktok_account": FetchTiktokAccountArgs;
+    "solari_fetch_tiktok_account_search": FetchTiktokAccountSearchArgs;
     "solari_fetch_tiktok_post": FetchTiktokPostArgs;
+    "solari_fetch_tiktok_post_search": FetchTiktokPostSearchArgs;
     "solari_fetch_tiktok_posts": FetchTiktokPostsArgs;
     "solari_insight_instagram_account_ad_posts": InsightInstagramAccountAdPostsArgs;
     "solari_insight_instagram_account_collabs": InsightInstagramAccountCollabsArgs;
@@ -817,25 +837,33 @@ export interface SolariTools {
         };
         threads: {
             account: {
-                /** Reads one Meta Threads account by exact username and returns its profile: display name, biography, follower count, verified and private flags, bio links, profile picture and URL. Threads is fetch-only in SOLARI: there are no catalog or insight tools for it, so call this directly with the exact handle and read the answer from the response; when you only know a name, find the handle with solari_fetch_threads_account_search first. A handle SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds, and fetched_on_demand=true marks that case; repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned; collected_at says when. Media URLs right after a collection may be temporary, so read them promptly. Nothing is enrolled in ongoing tracking. A handle with no Threads profile answers a not-found error. Works with any signed-in SOLARI account. */
+                /** Reads one Meta Threads account by exact username and returns its profile: display name, biography, follower count, verified and private flags, bio links, profile picture and URL. When you only know a name, find the handle with solari_fetch_threads_account_search first. A handle SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds, and fetched_on_demand=true marks that case; repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned; collected_at says when. Media URLs right after a collection may be temporary, so read them promptly. Nothing is enrolled in ongoing tracking. A handle with no Threads profile answers a not-found error. Works with any signed-in SOLARI account. */
                 <T = unknown>(args: FetchThreadsAccountArgs): Promise<T>;
-                /** Looks Meta Threads accounts up live by name or handle fragment and returns thin hits in Threads' own order: username, display name, profile picture, verified flag and URL (limit up to 20, default 10). Threads is fetch-only in SOLARI: there are no catalog or insight tools for it, and this is its account search, so use it when you know a name but not the exact handle. Official accounts may not rank first, so check the hits before choosing one. Hits carry no account_id and nothing is stored; call solari_fetch_threads_account with the chosen username for the full profile (follower count, biography, bio links) and solari_fetch_threads_posts for its posts. Every call asks Threads live, takes a second or two, is not cached, and costs 1 credit. An empty items list means Threads matched nothing. Works with any signed-in SOLARI account. */
+                /** Looks Meta Threads accounts up live by name or handle fragment and returns thin hits in Threads' own order: username, display name, profile picture, verified flag and URL (limit up to 20, default 10). Use it when you know a name but not the exact handle. Official accounts may not rank first, so check the hits before choosing one. Hits carry no account_id and nothing is stored; call solari_fetch_threads_account with the chosen username for the full profile (follower count, biography, bio links) and solari_fetch_threads_posts for its posts. Every call asks Threads live, takes a second or two, and is not cached. An empty items list means Threads matched nothing. Works with any signed-in SOLARI account. */
                 search<T = unknown>(args: FetchThreadsAccountSearchArgs): Promise<T>;
             };
             post: {
-                /** Reads one Meta Threads post by its public URL or permalink code and returns it with its author and the first batch of direct replies (replies_limit, default 20, max 50, most liked first; 0 skips them). Accepts https://www.threads.com/@<handle>/post/<code> (threads.net too) as url, or the bare code. Threads is fetch-only in SOLARI: there are no catalog or insight tools for it, so call this directly and read the post from the response. A post SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds (fetched_on_demand=true); repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned. Replies are the first batch only, so the post's reply_count can exceed the replies returned. Media URLs right after a collection may be temporary, so read them promptly; assets carry a direct-download asset_url. A reference with no public post answers a not-found error. Run next with the returned username to read the author's profile and posts. Works with any signed-in SOLARI account. */
+                /** Reads one Meta Threads post by its public URL or permalink code and returns it with its author and the first batch of direct replies (replies_limit, default 20, max 50, most liked first; 0 skips them). Accepts https://www.threads.com/@<handle>/post/<code> (threads.net too) as url, or the bare code. A post SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds (fetched_on_demand=true); repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned. Replies are the first batch only, so the post's reply_count can exceed the replies returned. Media URLs right after a collection may be temporary, so read them promptly; assets carry a direct-download asset_url. A reference with no public post answers a not-found error. Run next with the returned username to read the author's profile and posts. Works with any signed-in SOLARI account. */
                 <T = unknown>(args?: FetchThreadsPostArgs): Promise<T>;
-                /** Searches Meta Threads live for posts matching a keyword and returns Threads' top results: one page of about 20 posts (limit up to 25) in Threads' own relevance order, each with full post fields (text, hashtags, mentions, like, reply, repost and quote counts, author username, url, and assets with a direct-download asset_url). Threads is fetch-only in SOLARI: there are no catalog or insight tools for it, and this is its keyword search. Only Threads' top tab is available: there is no recent tab and no further page, so calling again with the same query returns the same page, and results may include loosely related posts. The matching posts are collected and stored, so solari_fetch_threads_post can read any of them with its replies and solari_fetch_threads_account can read an author. Every call asks Threads live, takes a few seconds, is not cached, and costs 1 credit. An empty items list means Threads found no public post for the keyword. Works with any signed-in SOLARI account. */
+                /** Searches Meta Threads live for posts matching a keyword and returns Threads' top results: one page of about 20 posts (limit up to 25) in Threads' own relevance order, each with full post fields (text, hashtags, mentions, like, reply, repost and quote counts, author username, url, and assets with a direct-download asset_url). Only Threads' top tab is available: there is no recent tab and no further page, so calling again with the same query returns the same page, and results may include loosely related posts. The matching posts are collected and stored, so solari_fetch_threads_post can read any of them with its replies and solari_fetch_threads_account can read an author. Every call asks Threads live, takes a few seconds, and is not cached. An empty items list means Threads found no public post for the keyword. Works with any signed-in SOLARI account. */
                 search<T = unknown>(args: FetchThreadsPostSearchArgs): Promise<T>;
             };
-            /** Reads the recent top-level posts of one Meta Threads account by exact username, newest first, together with its profile. limit picks how many (default 12, max 25); each post carries text, hashtags, mentions, links, like, reply, repost and quote counts, the quoted post, and assets with a direct-download asset_url. Threads is fetch-only in SOLARI: there are no catalog or insight tools for it, so call this directly with the handle and read the posts from the response. A handle SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds (fetched_on_demand=true); repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned. Media URLs right after a collection may be temporary, so read them promptly. A private account answers its profile with posts empty. The account's own replies are not listed: solari_fetch_threads_post reads one post with its replies. A handle with no Threads profile answers a not-found error. Works with any signed-in SOLARI account. */
+            /** Reads the recent top-level posts of one Meta Threads account by exact username, newest first, together with its profile. limit picks how many (default 12, max 25); each post carries text, hashtags, mentions, links, like, reply, repost and quote counts, the quoted post, and assets with a direct-download asset_url. A handle SOLARI has never collected is collected live now, which takes roughly 5 to 30 seconds (fetched_on_demand=true); repeat calls within an hour return the stored copy (fetched_on_demand=false) unless refresh=true forces a new collection. stale=true means the live collection failed and an older stored copy is returned. Media URLs right after a collection may be temporary, so read them promptly. A private account answers its profile with posts empty. The account's own replies are not listed: solari_fetch_threads_post reads one post with its replies. A handle with no Threads profile answers a not-found error. Works with any signed-in SOLARI account. */
             posts<T = unknown>(args: FetchThreadsPostsArgs): 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>;
+            account: {
+                /** 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. */
+                <T = unknown>(args: FetchTiktokAccountArgs): Promise<T>;
+                /** Looks TikTok accounts up live by name or handle fragment and returns thin hits in TikTok's own order: username, nickname, bio, verified flag, follower count, profile picture and URL (limit up to 30, default 10). Use it when solari_catalog_tiktok_account_search does not know the account, or when you know a name but not the exact handle. Hits already in the SOLARI catalog carry account_id for the solari_catalog_tiktok_* tools; for the rest account_id is null, so call solari_fetch_tiktok_account with the chosen username to add it. When has_more is true, pass next_cursor back as cursor with the same query for the next page; next_cursor is null on the last page. Nothing is stored. Every call asks TikTok live, takes a few seconds, and is not cached. An empty items list means TikTok matched nothing. Works with any signed-in SOLARI account. */
+                search<T = unknown>(args: FetchTiktokAccountSearchArgs): Promise<T>;
+            };
+            post: {
+                /** 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. */
+                <T = unknown>(args: FetchTiktokPostArgs): Promise<T>;
+                /** Searches TikTok live for videos matching a keyword and returns thin hits in TikTok's own relevance order: video_id, url, author username, caption, posted_at, play, like, comment and share counts, duration and cover image (limit up to 30, default 20). Use it when you want what people post on TikTok about a topic, brand or phrase and have no handle to start from. Hits are not stored and carry no post_id; call solari_fetch_tiktok_post with a hit's url to collect and store the full post with its author. When has_more is true, pass next_cursor back as cursor with the same query for the next page; next_cursor is null on the last page. Every call asks TikTok live, takes a few seconds, and is not cached. An empty items list, with a note, means TikTok found no public video for the keyword. Works with any signed-in SOLARI account. */
+                search<T = unknown>(args: FetchTiktokPostSearchArgs): 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>;
         };

package/dist/tools.generated.js

@@ -28,7 +28,9 @@ export const SOLARI_TOOL_NAMES = [
     "solari_fetch_threads_post_search",
     "solari_fetch_threads_posts",
     "solari_fetch_tiktok_account",
+    "solari_fetch_tiktok_account_search",
     "solari_fetch_tiktok_post",
+    "solari_fetch_tiktok_post_search",
     "solari_fetch_tiktok_posts",
     "solari_insight_instagram_account_ad_posts",
     "solari_insight_instagram_account_collabs",

package/package.json

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