> ## Documentation Index
> Fetch the complete documentation index at: https://docs.macrovisonomics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart Search

> Search 500,000+ economic indicators from 16+ sources using natural language — just type what you want to know and MACROVISONOMICS finds the data

# Smart Search

MACROVISONOMICS uses intelligent search technology to understand your questions and find relevant economic data instantly.

## How Smart Search Works

Simply type what you're looking for in everyday language. The system understands your intent and finds matching indicators, countries, and suggests appropriate visualizations.

### What You Type → What You Get

| Your Query                                | System Understands                               |
| ----------------------------------------- | ------------------------------------------------ |
| "GDP growth in G7 countries"              | Indicator: GDP growth rate, Countries: G7 bloc   |
| "Compare inflation between US and Europe" | Indicator: CPI inflation, Regions: USA vs EU     |
| "Show me unemployment trends since 2010"  | Indicator: Unemployment rate, Time: 2010-present |
| "Carbon emissions per capita in BRICS"    | Indicator: CO2/capita, Countries: BRICS nations  |

## Search Modes

Choose the search mode that best fits your needs:

<CardGroup cols={3}>
  <Card title="Neural Search" icon="brain">
    **Default mode.** AI understands the meaning behind your query and finds semantically similar indicators — even if you use different words than the official indicator names.
  </Card>

  <Card title="Keyword Search" icon="zap">
    Exact text matching for when you know the specific indicator code or name. Fast and precise.
  </Card>

  <Card title="Research Mode" icon="book-open">
    Deep multi-step analysis that goes beyond simple search. The AI agent researches your question comprehensively, gathering data from multiple sources before presenting results.
  </Card>
</CardGroup>

## Search Features

### Intent Recognition

Smart Search recognizes different types of queries:

<CardGroup cols={2}>
  <Card title="Indicator Search" icon="chart-line">
    "GDP per capita" → Finds GDP per capita indicators
  </Card>

  <Card title="Country/Region" icon="globe">
    "European unemployment" → Scopes to EU countries
  </Card>

  <Card title="Time Periods" icon="calendar">
    "Since 2015" or "Last decade" → Sets date range
  </Card>

  <Card title="Comparisons" icon="scale-balanced">
    "Compare X and Y" → Sets up comparison view
  </Card>
</CardGroup>

### Entity Extraction

The system automatically extracts:

* **Countries**: Individual nations by name or ISO codes (USA, GBR, CHN, etc.)
* **Economic Blocs**: G7, G20, BRICS/BRICS+, EU/EA20, OECD, ASEAN, NAFTA/USMCA, MERCOSUR, GCC, APEC, Nordic
* **Regions**: East Asia & Pacific, Europe & Central Asia, Latin America & Caribbean, Middle East & North Africa, North America, South Asia, Sub-Saharan Africa
* **Income Levels**: High income, Upper middle income, Lower middle income, Low income
* **Lending Types**: IBRD, IDA, Blend countries
* **Time Ranges**: Specific years, decades, "since X", "last N years"

### Semantic Matching

Smart Search understands synonyms and related concepts:

| You Say              | System Finds                     |
| -------------------- | -------------------------------- |
| "jobless rate"       | Unemployment rate                |
| "cost of living"     | Consumer price index / Inflation |
| "carbon footprint"   | CO2 emissions per capita         |
| "life span"          | Life expectancy at birth         |
| "foreign investment" | Foreign Direct Investment (FDI)  |

## Search Examples

### Basic Searches

```
GDP growth
unemployment rates
inflation trends
population growth
```

### With Countries

```
US GDP growth
China vs India population
European unemployment
BRICS trade balance
```

### With Time

```
GDP growth since 2010
unemployment last 5 years
inflation 2015 to 2023
CO2 emissions past decade
```

### Complex Queries

```
Compare G7 and BRICS GDP per capita from 2010 to 2024
Show me renewable energy consumption in European countries
How has life expectancy changed in developing nations
```

## Search Results

### Indicator Results

After searching, you'll see:

* **Primary Match**: The most relevant indicator
* **Related Indicators**: Similar metrics you might also need
* **Data Preview**: Quick look at available data

### Data Availability

Results show:

* Which countries have data
* Time range available
* Data source (World Bank, FRED, IMF, OECD, or other source)
* Last updated date

## Advanced Features

### Follow-Up Suggestions

After your initial search, Smart Search suggests related queries:

<Accordion title="Example: After searching 'GDP growth'">
  Related suggestions:

  * "Compare GDP growth across regions"
  * "Show GDP growth vs inflation"
  * "Add more G7 countries"
  * "Extend time range to 2000"
</Accordion>

### Query Refinement

Refine your search by:

* Adding more countries
* Changing the time period
* Switching indicators
* Adjusting the chart type

### Search History

Your recent searches are saved for quick access:

* View past queries on the home page
* Click to repeat a previous search
* Clear history from Settings

## Smart Search vs Agent Chat

Smart Search and Agent Chat are separate experiences:

* **Smart Search** finds economic indicators and creates visualizations from your natural language queries. It's optimized for data discovery and chart creation.
* **Agent Chat** (available in the Analysis tab) lets you have back-and-forth conversations with specialized AI agents about your data. Agent chat now supports **conversational context** — it remembers up to 20 turns of dialogue, so you can ask follow-up questions and refine your analysis naturally.

Use Smart Search to find and visualize data. Use Agent Chat to explore, analyze, and ask deeper questions about what you've found.

## Tips for Better Results

<AccordionGroup>
  <Accordion title="Be Specific">
    "GDP per capita growth in emerging markets" works better than just "GDP"
  </Accordion>

  <Accordion title="Use Natural Language">
    "How has inflation changed in the US" is understood perfectly
  </Accordion>

  <Accordion title="Include Context">
    Adding time periods and regions improves results
  </Accordion>

  <Accordion title="Try Alternatives">
    If one search doesn't work, try synonyms or related terms
  </Accordion>
</AccordionGroup>

## Agent Processing Steps

When you perform an AI-powered search (Neural or Research mode), you'll see the **Agent Processing Steps** — a visual indicator showing real-time progress through 5 stages:

1. **Understanding your query**: Parses your natural language input
2. **Searching for indicators**: Finds matching economic metrics across 16+ sources
3. **Fetching data**: Retrieves information from the relevant sources
4. **Preparing visualization**: Formats data for charting
5. **Analyzing results**: Generates AI-powered insights

As each step completes, you'll also see detected entities — including recognized countries, matched indicators, and suggested chart types — displayed in real time. This gives you full visibility into what the AI is doing behind the scenes.