# ObekT Finance - Stock Analysis Reports (`aiaisir/obekt-finance---stock-analysis-reports`) Actor

Real-time AI-powered stock analysis reports. Provide a stock ticker symbol and get a comprehensive financial report.

- **URL**: https://apify.com/aiaisir/obekt-finance---stock-analysis-reports.md
- **Developed by:** [Veselin Vasilev](https://apify.com/aiaisir) (community)
- **Categories:** MCP servers, Integrations, Agents
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.001 / actor start

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## ObekT Finance - Stock Analysis Reports

**Get AI-powered stock analysis reports for any publicly traded company.** One ticker symbol in, a full analyst-style report out — with current price data, aggregated news, sector trends, a buy/hold/sell recommendation, and alternative stock suggestions.

Built as a native **MCP server**, this tool plugs directly into Claude, Cursor, OpenAI agents, and any MCP-compatible AI client.

---

### What does ObekT Finance do?

ObekT Finance takes a stock ticker symbol (like `AAPL` or `TSLA`) and generates a comprehensive financial analysis report in seconds. It aggregates **real-time data from multiple sources** — Yahoo Finance for market data and company news, Financial Times for global market context, and Fortune for business news — then uses AI to synthesize everything into an actionable report.

Unlike simple price lookup tools, ObekT Finance delivers **the full picture**: what the stock is doing today, why it's moving, what the sector looks like, and whether you should buy, hold, or sell.

Running on Apify means you get reliable uptime, automatic scaling, API access, and seamless integration with AI agents — no infrastructure to manage.

---

### Why use ObekT Finance?

- **Save hours of research** — Get what would take 30+ minutes of reading condensed into one report
- **Real-time data** — Current prices and today's news, not stale data
- **Multi-source analysis** — Yahoo Finance + Financial Times + Fortune, cross-referenced
- **Actionable output** — Clear Buy/Hold/Sell recommendation with reasoning, not just raw data
- **MCP-native** — Works directly as a tool in AI agents (Claude, Cursor, custom agents)
- **Any stock** — Works for any publicly traded US stock ticker

---

### How to use ObekT Finance

1. Go to the **Input** tab on this actor's page
2. Enter a stock ticker symbol (e.g. `AAPL`, `TSLA`, `NVDA`, `MSFT`)
3. Click **Start** to run the actor
4. View your report in the **Output** tab

#### As an MCP tool in AI agents

Connect this actor as an MCP server in your AI client. The tool `get_stock_report` will be automatically discovered.

**Streamable HTTP (modern clients):**
````

https://aiaisir--obekt-finance---stock-analysis-reports.apify.actor/mcp

```

**SSE (legacy clients):**
```

https://aiaisir--obekt-finance---stock-analysis-reports.apify.actor/sse

````

Pass your Apify API token as a query parameter: `?token=YOUR_APIFY_TOKEN`

#### Via Apify API

```bash
curl -X POST "https://api.apify.com/v2/acts/aiaisir~obekt-finance---stock-analysis-reports/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"symbol": "AAPL"}'
````

***

### Input

| Field | Type | Required | Description |
|---|---|---|---|
| `symbol` | String | Yes | Stock ticker symbol (e.g. `AAPL`, `TSLA`, `NVDA`) |

***

### Output

The actor returns a detailed **markdown report** containing:

```json
{
  "symbol": "AAPL",
  "report": "## ObekT Finance Stock Analysis: Apple Inc. (AAPL)\n\n### 1. Market Data Overview\n- Current Price: $252.15\n- Day Range: $250.65 - $254.76\n- 52-Week Range: $169.21 - $288.62\n\n### 2. News Summary\n..."
}
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

#### Sample report sections

| Section | What's included |
|---|---|
| Market Data Overview | Current price, previous close, day range, 52-week range |
| News Summary | Key headlines and developments affecting the stock |
| Sector Analysis | Industry trends, macro factors, competitive landscape |
| Critical Events | Earnings, partnerships, leadership changes, regulatory actions |
| Recommendation | Buy / Hold / Sell with detailed reasoning |
| Alternative Stocks | 2-3 similar or adjacent-sector alternatives to consider |

***

### Example output (abbreviated)

```markdown
## ObekT Finance Stock Analysis: NVIDIA Corporation (NVDA)

### 1. Market Data Overview
- **Current Price:** $175.75
- **Day Range:** $174.76 - $177.37
- **52-Week Range:** $86.62 - $212.19

### 2. High-Level News Summary
NVIDIA is at a critical juncture defined by strong strategic partnerships
versus macroeconomic headwinds. The stock recently rallied 8% in three days...

### 3. Sector Analysis
- **Sector:** Technology / Semiconductors / AI Infrastructure
- AI Infrastructure Boom: DRAM prices surging 90-95%, suppliers booked out...

### 5. Recommendation: HOLD
- Bull Case: Central player in AI with deepening moats via partnerships...
- Bear Case: Short-term technicals suggest potential reversal...

### 6. Alternative Stocks
1. **Marvell Technology (MRVL)** - Direct beneficiary of $2B NVIDIA partnership
2. **ServiceNow (NOW)** - Expanding AI partnership with NVIDIA
3. **Lumentum Holdings (LITE)** - Outperforming in optical networking for AI
```

***

### Pricing

Each stock report costs a small fee per generation. The actor uses **Pay-Per-Event** pricing:

- Each `get_stock_report` call = 1 event
- Check the Pricing tab for current rates
- Free Apify tier includes platform credits to get started

Reports aggregate data from 3+ live sources and run AI analysis, so each call involves real-time data fetching and processing.

***

### Tips

- **Use standard US ticker symbols** — e.g. `AAPL` not `Apple` or `AAPL.US`
- **Reports reflect market hours** — Running during US market hours (9:30 AM - 4 PM ET) gives you the most current intraday data
- **Combine with other tools** — Use the report output as context for your AI agent to make portfolio decisions or draft investment memos

***

### FAQ and support

**What stocks are supported?**
Any publicly traded US stock with a Yahoo Finance ticker symbol.

**How current is the data?**
Market data is real-time from Yahoo Finance. News is aggregated from live RSS feeds (Yahoo Finance, Financial Times, Fortune).

**Can I use this in my own AI agent?**
Yes — this actor is an MCP server. Connect it to Claude, Cursor, or any MCP-compatible client using the endpoints listed above.

**Is this financial advice?**
No. Reports are for informational purposes only and do not constitute financial advice. Always conduct your own due diligence.

**Found a bug or have a suggestion?**
Open an issue in the **Issues** tab on this actor's page. For custom solutions or integrations, reach out through the same channel.

***

*Powered by [ObekT Finance](https://finance.obekt.com/) — real-time AI-driven stock analysis.*

# Actor input Schema

## `symbol` (type: `string`):

Stock ticker symbol to analyze (e.g. AAPL, TSLA, MSFT, NVDA)

## Actor input object example

```json
{
  "symbol": "AAPL"
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "symbol": "AAPL"
};

// Run the Actor and wait for it to finish
const run = await client.actor("aiaisir/obekt-finance---stock-analysis-reports").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "symbol": "AAPL" }

# Run the Actor and wait for it to finish
run = client.actor("aiaisir/obekt-finance---stock-analysis-reports").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "symbol": "AAPL"
}' |
apify call aiaisir/obekt-finance---stock-analysis-reports --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=aiaisir/obekt-finance---stock-analysis-reports",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "ObekT Finance - Stock Analysis Reports",
        "description": "Real-time AI-powered stock analysis reports. Provide a stock ticker symbol and get a comprehensive financial report.",
        "version": "0.0",
        "x-build-id": "ckSLX779dpnCfKjTW"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/aiaisir~obekt-finance---stock-analysis-reports/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-aiaisir-obekt-finance---stock-analysis-reports",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/aiaisir~obekt-finance---stock-analysis-reports/runs": {
            "post": {
                "operationId": "runs-sync-aiaisir-obekt-finance---stock-analysis-reports",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/aiaisir~obekt-finance---stock-analysis-reports/run-sync": {
            "post": {
                "operationId": "run-sync-aiaisir-obekt-finance---stock-analysis-reports",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "symbol"
                ],
                "properties": {
                    "symbol": {
                        "title": "Stock Symbol",
                        "type": "string",
                        "description": "Stock ticker symbol to analyze (e.g. AAPL, TSLA, MSFT, NVDA)",
                        "default": "AAPL"
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
