@brandazine/solari-sdk 0.2.10 → 0.2.11

package/README.md

@@ -21,6 +21,8 @@ const tools = await solari.listTools();
 
 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.
 
 Create an API key on your [SOLARI My page](https://solari.brandazine.com/me/api-keys) (long-lived, `solari_sk_…`, shown once), or mint a short-lived token with `solari auth token` on a machine signed in to the [solari CLI](https://solari.sh/docs). With no `token` option the client reads `SOLARI_TOKEN`.

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.10";
+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.10";
+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

@@ -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;
@@ -832,10 +852,18 @@ export interface SolariTools {
             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.10",
+	"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",