Visual answers

#Visual intelligence across markets

Store listings and creative ads are primarily visual. Over MCP, threefold delivers visual evidence across its unified tools (docs/agent-tools.md):

• app: Returns screenshot previews and localized visual assets across storefronts, ad creative frames, and video hooks.
• market: Shows opening screenshots of top apps in a market and creative formats of winning ads.
• check (what: "screenshots" or "ad"): Delivers visual criteria, orientation norms, layout patterns, and competitor reference examples for the agent to grade proposed assets.

Over REST, GET /api/visuals/gallery remains available for programmatic access:

Common query parameters: store (ios default, or play), limit (1 to 20, default 5), and image_format (webp default, or jpg).

#What each visual asset carries

• Inline previews: Up to 6 low-resolution image previews (MCP image content), resized server-side, for the model to inspect directly.
• image_url: The full-size image URL for download or export. When threefold's media archive holds a copy, this points to the archive copy; otherwise it points to the platform's CDN.
• store_url / ad link: Direct URLs to cite for every visual claim.
• threefold.eco link: A direct link in each digest for the user to inspect the full visual gallery in their browser.

Previews are fetched only from verified CDN hosts with bounded concurrency and timeouts. If an image cannot be retrieved, the item carries preview_error; threefold never substitutes another image.

#Saved items and team memory

Keep evidence per project or client:

• Over MCP: Call workspace with action: "save" to keep a brief, check result, or competitor finding, and action: "saved" to inspect saved items.
• Over REST:
  • POST /api/collections/save: Save an item to a collection by ID or name, or to all-saved.
  • GET /api/collections: List workspace collections.
  • GET /api/collections/:id: Fetch items in a collection.
  • POST /api/collections/notes: Add a note to a saved item.

#Visual brief (REST)

POST /api/analysis/visual-brief is a server-side AI analysis of screenshot composition, cultural adaptation and framing in a market (for example, what top Japanese fitness apps show in screenshot 1). Over MCP, check with what: "screenshots" returns the market criteria and references so your agent can grade composition locally. See AI analyses.