All tools
tiktok · fetchsolari:readWorks with any signed-in SOLARI account.

solari fetch tiktok account

Ingest one TikTok handle into the catalog.

MCP tool
solari_fetch_tiktok_account
CLI
solari fetch tiktok account
Access
solari:readWorks with any signed-in SOLARI account.Works with any signed-in SOLARI account.
Required plan
Free
Credit
0

Overview

Add one TikTok account to the SOLARI catalog by exact username. This is not a search. If it is already stored, nothing is scraped.

When to use itWhen catalog search does not know an exact handle you already have.

What comes backWhether it was ingested, the account_id, and the catalog command to read it.

Parameters

usernamestringrequired
TikTok username.≤ 64 chars

Response

Response

ingestedboolean
true if this call collected it live.
already_trackedboolean
true if it was already in the catalog.
fetched_on_demandboolean
Same as ingested.
account_iduuid
The ingested account.
usernamestring
Resolved handle.
notestring
What to expect next.
nextstring
Catalog command to read the result.

Example

Request

$ solari fetch tiktok account username=innisfree_official

Response · Long strings and repeated array entries are trimmed for readability.

{
  "ingested": false,
  "already_tracked": true,
  "fetched_on_demand": false,
  "account_id": "01a0631e-f0df-7e9d-a09b-d84bc31d3834",
  "username": "innisfree_official",
  "note": "Already in the SOLARI catalog. Nothing was scraped.",
  "next": "solari catalog tiktok account profile username=innisfree_official"
}

As an MCP call

{
  "name": "solari_fetch_tiktok_account",
  "arguments": {
    "username": "innisfree_official"
  }
}

Notes

  • Do not use this to search a name. Use catalog account search first.
  • A first-time ingest can take 10 to 40 seconds. Only recent posts exist until the crawl finishes.

Machine-readable: /docs/tools/fetch-tiktok-account.md