Research

Rules

• Always cite sources. Every claim backed by Expert System data must include the source name and a direct link from the takeaway or document metadata. Never present retrieved information without attribution.
• If the API returns an error or empty results, tell the user plainly rather than guessing.
• If no API key is configured, tell the user they need an API key to use Expert System and can get one at expert-system.starmode.dev/account/api-keys. Do not attempt the request without a key.
• If the API returns a 401, the key may be invalid or expired. Direct the user to expert-system.starmode.dev/account/api-keys to check or regenerate their key.
• Cross-reference with other skills. If the user's question would benefit from financial or macroeconomic data, use the

  financials

  or

  macro

  skills alongside this one.

Authentication

${user_config.api_key}

EXPERT_SYSTEM_API_KEY

.env

Authorization: Bearer <api_key>

Workflows

Ad-hoc Research

1. Search —

   GET /takeaways/search

   with a natural-language query. Use

   recent=true

   to favor newer content. Returns titles, summaries, and IDs.
2. Read takeaways —

   GET /takeaways?ids=...

   to get full text, references, and document URLs.
3. Read sources (if needed) —

   GET /documents?ids=...

   for the full source text.

News Briefing

1. Research insights —

   GET /research

   for AI-synthesized insights (highest signal).
2. Recent takeaways —

   GET /takeaways/recent

   for the latest raw takeaways.
3. Drill down — Fetch by ID to go deeper on anything interesting.

API Reference

https://expert-system.starmode.dev/api/v1

Semantic Search —

GET /takeaways/search

query

limit

recent

true

Takeaways by ID —

GET /takeaways

ids

Recent Takeaways —

GET /takeaways/recent

limit

Documents by ID —

GET /documents

ids

Research Insights —

GET /research

limit

date

cursor

Output