Yahoo Finance Market Data & Fundamentals Scraper: MCP config, n8n workflow and API

{
  "mode": "tickers",
  "tickers": [
    "AAPL"
  ],
  "searchQuery": "Apple",
  "maxSearchResults": 10,
  "screenerId": "day_gainers",
  "screenerSort": "intradaymarketcap",
  "region": "US",
  "language": "en-US",
  "range": "5d",
  "interval": "1d",
  "includePrePost": false,
  "includeHistory": false,
  "includeDividends": false,
  "includeSplits": false,
  "includeNews": false,
  "maxNews": 10,
  "includeFinancials": false,
  "includeQuarterlyFinancials": false,
  "includeHolders": false,
  "includeInsiders": false,
  "includeOptions": false,
  "optionExpirations": 1,
  "maxOptionContracts": 50,
  "optionContractType": "both",
  "includeRecommendations": false,
  "includeUpgradesDowngrades": false,
  "includeAnalystPriceTargets": false,
  "includeEarningsHistory": false,
  "includeEarningsEstimates": false,
  "includeEarningsCalendar": false,
  "includeFundData": false,
  "includeSecFilings": false,
  "includeInsights": false,
  "includeRelatedSymbols": false,
  "maxResults": 1,
  "concurrency": 1
}

---
name: yahoo-finance-market-data-and-fundamentals-scraper
description: "Dataset with ticker quotes (including US post-market fields), OHLCV history, expanded financial statements, dividends, splits, up to 200 news items, analyst and earnings data, holders, options, fund data with bond ratings and sector weights, SEC filings, insights, search results, custom and predefined screener rows, trending symbols and market summary rows. Runs the Apify Actor nimbryxo-studio/yahoo-finance-market-data-and-fundamentals-scraper. Use when the user needs Yahoo Finance data with fields such as ticker, companyName, sector, industry, currency, currentPrice and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "nimbryxo-studio/yahoo-finance-market-data-and-fundamentals-scraper"
  store-url: "https://apify.com/nimbryxo-studio/yahoo-finance-market-data-and-fundamentals-scraper"
---

# Yahoo Finance Market Data & Fundamentals Scraper

Use this skill to fetch Yahoo Finance data with the Apify Actor `nimbryxo-studio/yahoo-finance-market-data-and-fundamentals-scraper` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | one of `tickers`, `search`, `screener`, `customScreener`, `trending`, `marketSummary`, required | What to scrape. |
| `tickers` | array | Symbols or Yahoo Finance quote URLs (mode=tickers). Examples: `AAPL`, `BRK.B`, `^GSPC`, `EURUSD=X`, `BTC-USD`, `7203.T`, `https://finance.yahoo.com/quote/AAPL/`. |
| `searchQuery` | string | Company, fund, index, currency or crypto name to search for (mode=search). |
| `maxSearchResults` | integer | Maximum number of search results to return (mode=search). |
| `screenerId` | string | Yahoo predefined screener to run (mode=screener). Predefined screeners are US-centric; use mode=customScreener for a region-aware list. |
| `screenerSort` | one of `intradaymarketcap`, `percentchange`, `dayvolume` | Sort field for mode=customScreener. |
| `region` | string | Yahoo market region used for quotes, search, trending, localization and mode=customScreener. |
| `language` | string | Language used for names, news and localized labels. |
| `range` | string | History range used when no start/end dates are supplied (mode=tickers). |
| `interval` | string | Candle interval. Intraday intervals have shorter Yahoo range limits; incompatible combinations are clamped and reported in the run status. |
| `includePrePost` | boolean | Include extended-hours bars for intraday history. |
| `includeHistory` | boolean | Include historical bars with adjusted close. |
| `includeDividends` | boolean | Include the full dividend history from Yahoo chart events. |
| `includeSplits` | boolean | Include stock-split history with numerator and denominator. |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "tickers",
  "tickers": [
    "AAPL"
  ],
  "searchQuery": "Apple",
  "maxSearchResults": 10,
  "screenerId": "day_gainers",
  "screenerSort": "intradaymarketcap",
  "region": "US",
  "language": "en-US",
  "range": "5d",
  "interval": "1d",
  "includePrePost": false,
  "includeHistory": false,
  "includeDividends": false,
  "includeSplits": false,
  "includeNews": false,
  "maxNews": 10,
  "includeFinancials": false,
  "includeQuarterlyFinancials": false,
  "includeHolders": false,
  "includeInsiders": false,
  "includeOptions": false,
  "optionExpirations": 1,
  "maxOptionContracts": 50,
  "optionContractType": "both",
  "includeRecommendations": false,
  "includeUpgradesDowngrades": false,
  "includeAnalystPriceTargets": false,
  "includeEarningsHistory": false,
  "includeEarningsEstimates": false,
  "includeEarningsCalendar": false,
  "includeFundData": false,
  "includeSecFilings": false,
  "includeInsights": false,
  "includeRelatedSymbols": false,
  "maxResults": 1,
  "concurrency": 1
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~yahoo-finance-market-data-and-fundamentals-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/nimbryxo-studio~yahoo-finance-market-data-and-fundamentals-scraper/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `ticker`, `companyName`, `sector`, `industry`, `currency`, `currentPrice`, `marketCap`, `dayChangePercent`, `marketState`, `sourceUrl`, `recordType`, `name`, `longName`, `shortName`, `exchange`, `quoteType`, `screenerId`, `screenerName`, `region`, `rank`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.