@brandazine/solari-sdk 0.2.4 → 0.2.5

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

package/dist/tools.generated.d.ts

@@ -194,6 +194,47 @@ 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. */
+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. */
+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. */
+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;
+    /** Permalink code of the post, the segment after /post/ in its URL. Provide this or url, not both. */
+    "code"?: string | undefined;
+    /** Replies to return, default 20. 0 returns none. Values above 50 are clamped to 50. */
+    "replies_limit"?: number | undefined;
+    /** 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. */
+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. */
+export interface FetchThreadsPostsArgs {
+    /** Threads handle, with or without a leading @. */
+    "username": string;
+    /** Posts to return, default 12. Values above 25 are clamped to 25. */
+    "limit"?: number | undefined;
+    /** true collects the account and its posts again even when a copy from the last hour exists. Default false. */
+    "refresh"?: boolean | undefined;
+}
 /** 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. */
 export interface FetchTiktokAccountArgs {
     /** TikTok handle, with or without a leading @. */
@@ -603,6 +644,11 @@ export interface SolariToolMap {
     "solari_fetch_instagram_hashtag_search": FetchInstagramHashtagSearchArgs;
     "solari_fetch_instagram_post": FetchInstagramPostArgs;
     "solari_fetch_instagram_posts": FetchInstagramPostsArgs;
+    "solari_fetch_threads_account": FetchThreadsAccountArgs;
+    "solari_fetch_threads_account_search": FetchThreadsAccountSearchArgs;
+    "solari_fetch_threads_post": FetchThreadsPostArgs;
+    "solari_fetch_threads_post_search": FetchThreadsPostSearchArgs;
+    "solari_fetch_threads_posts": FetchThreadsPostsArgs;
     "solari_fetch_tiktok_account": FetchTiktokAccountArgs;
     "solari_fetch_tiktok_post": FetchTiktokPostArgs;
     "solari_fetch_tiktok_posts": FetchTiktokPostsArgs;
@@ -642,6 +688,7 @@ export type SolariToolsWithoutRequiredArgs = {
     "solari_catalog_tiktok_account_profile": true;
     "solari_catalog_tiktok_content_detail": true;
     "solari_fetch_instagram_post": true;
+    "solari_fetch_threads_post": true;
     "solari_insight_instagram_account_ad_posts": true;
     "solari_insight_instagram_account_collabs": true;
     "solari_insight_instagram_brand_lookalike_content": true;
@@ -722,6 +769,22 @@ export interface SolariTools {
             /** 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>;
         };
+        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. */
+                <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. */
+                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. */
+                <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. */
+                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. */
+            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>;

package/dist/tools.generated.js

@@ -20,6 +20,11 @@ export const SOLARI_TOOL_NAMES = [
     "solari_fetch_instagram_hashtag_search",
     "solari_fetch_instagram_post",
     "solari_fetch_instagram_posts",
+    "solari_fetch_threads_account",
+    "solari_fetch_threads_account_search",
+    "solari_fetch_threads_post",
+    "solari_fetch_threads_post_search",
+    "solari_fetch_threads_posts",
     "solari_fetch_tiktok_account",
     "solari_fetch_tiktok_post",
     "solari_fetch_tiktok_posts",

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@brandazine/solari-sdk",
-	"version": "0.2.4",
-	"description": "TypeScript client for the SOLARI API — creator and brand intelligence across Instagram and TikTok.",
+	"version": "0.2.5",
+	"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",
 	"keywords": [
@@ -9,6 +9,7 @@
 		"brandazine",
 		"instagram",
 		"tiktok",
+		"threads",
 		"creator",
 		"influencer",
 		"brand",