# AlphaBook Breakout & Pattern MCP (`neeenja/alphabook-breakout-pattern`) Actor

Breakout & pattern signal engine as a remote MCP server. Five tools: detect_breakout, get_pivot_levels, detect_candlestick_pattern, get_volatility_breakout, rank_breakout.

- **URL**: https://apify.com/neeenja/alphabook-breakout-pattern.md
- **Developed by:** [Neeen Ja](https://apify.com/neeenja) (community)
- **Categories:** MCP servers, AI
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 analysis calls

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## AlphaBook Breakout & Pattern MCP

Breakout & pattern signal engine as a remote MCP server. It gives your agent **breakout / pattern verdicts with trigger levels and invalidation** — not a pile of raw bars. Five tools cover Donchian breakout, pivot levels, candlestick patterns, volatility-breakout readiness and a basket breakout scan. All metrics are pure price-derived and work on A-shares, HK, US and global markets through free public data. No API key. **Not investment advice.**

> **Honest boundary:** breakout signals have a high false-breakout rate in low-ADX (<20) ranging markets and the tool says so explicitly; candlestick patterns are OHLC-geometry only (no volume confirmation from the free source). Historical pattern edge is not a forward guarantee.

### Tools

| Tool | Event | Returns |
|------|-------|---------|
| `detect_breakout` | tool-call $0.02 | Donchian breakout vs N-day channel + ADX context + invalidation |
| `get_pivot_levels` | tool-call $0.02 | Floor-Trader pivots PP/R1-R3/S1-S3 + price position |
| `detect_candlestick_pattern` | tool-call $0.02 | Engulfing / hammer / star / doji with bias |
| `get_volatility_breakout` | tool-call $0.02 | ATR% + Bollinger-width expansion/contraction readiness |
| `rank_breakout` | **screen-call $0.05** | Basket scan: symbols breaking out, ranked by strength |

### Connect (MCP client)

```
https://neeenja--alphabook-breakout-pattern.apify.actor/mcp
Authorization: Bearer <APIFY_TOKEN>
```

POST JSON-RPC: `initialize`, `tools/list`, `tools/call`. Example:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "detect_breakout", "arguments": { "code": "600519" } }
}
```

### Pricing

Pay-per-event. `initialize` and `tools/list` are free. Each analysis call is **$0.02**; a basket breakout scan (`rank_breakout`) is **$0.05** because it scores up to 10 symbols.

### Data sources & honest limits

- **Klines:** Tencent `gtimg.cn` (A/HK/US) and Yahoo (global). Free, no key.
- Missing data → `n/a`, never a fabricated `0`.
- Every output carries a `NOT_ADVICE` disclaimer.

***

## AlphaBook 突破与形态 MCP

突破与形态信号引擎，以远程 MCP 服务器形式提供。它给 agent 的是 **突破/形态判定 + 触发位 + 失效位**，而非一堆原始 K 线。五个工具覆盖唐奇安突破、枢轴位、K 线形态、波动率突破蓄势与篮子突破扫描。全部纯价格派生，支持 A 股、港股、美股与全球市场，免费公开数据，无需 API Key。**不构成投资建议。**

> **诚实边界：** 低 ADX（<20）区间震荡市假突破率高，工具会明确标注；K 线形态仅为 OHLC 几何判定（免费源无成交量确认维度）。历史形态胜率≠未来。

### 工具

| 工具 | 计费事件 | 返回 |
|------|----------|------|
| `detect_breakout` | tool-call $0.02 | N 日唐奇安突破 + ADX 环境 + 失效位 |
| `get_pivot_levels` | tool-call $0.02 | 枢轴位 PP/R1-R3/S1-S3 + 现价相对位置 |
| `detect_candlestick_pattern` | tool-call $0.02 | 吞没 / 锤头 / 星线 / 十字星及偏向 |
| `get_volatility_breakout` | tool-call $0.02 | ATR% + 布林带宽扩张/收敛蓄势度 |
| `rank_breakout` | **screen-call $0.05** | 篮子扫描：正在突破的标的按强度排名 |

### 连接（MCP 客户端）

```
https://neeenja--alphabook-breakout-pattern.apify.actor/mcp
Authorization: Bearer <APIFY_TOKEN>
```

发送 JSON-RPC：`initialize`、`tools/list`、`tools/call`。示例：

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "detect_breakout", "arguments": { "code": "600519" } }
}
```

### 计费

按事件付费。`initialize` 与 `tools/list` 免费。每次分析调用 **$0.02**；篮子突破扫描（`rank_breakout`）为 **$0.05**，因其最多扫描 10 只标的。

### 数据源与诚实边界

- **K 线：** 腾讯 `gtimg.cn`（A/港/美）与 Yahoo（全球），免费、无 Key。
- 数据缺失 → 返回 `n/a`，绝不编造 `0`。
- 所有输出均带 `NOT_ADVICE` 免责声明。

***

## AlphaBook 突破與形態 MCP

突破與形態訊號引擎，以遠端 MCP 伺服器形式提供。它給 agent 的是 **突破/形態判定 + 觸發位 + 失效位**，而非一堆原始 K 線。五個工具涵蓋唐奇安突破、樞軸位、K 線形態、波動率突破蓄勢與籃子突破掃描。全部純價格派生，支援 A 股、港股、美股與全球市場，免費公開資料，無需 API Key。**不構成投資建議。**

> **誠實邊界：** 低 ADX（<20）區間震盪市假突破率高，工具會明確標註；K 線形態僅為 OHLC 幾何判定（免費源無成交量確認維度）。歷史形態勝率≠未來。

### 工具

| 工具 | 計費事件 | 回傳 |
|------|----------|------|
| `detect_breakout` | tool-call $0.02 | N 日唐奇安突破 + ADX 環境 + 失效位 |
| `get_pivot_levels` | tool-call $0.02 | 樞軸位 PP/R1-R3/S1-S3 + 現價相對位置 |
| `detect_candlestick_pattern` | tool-call $0.02 | 吞沒 / 錘頭 / 星線 / 十字星及偏向 |
| `get_volatility_breakout` | tool-call $0.02 | ATR% + 布林帶寬擴張/收斂蓄勢度 |
| `rank_breakout` | **screen-call $0.05** | 籃子掃描：正在突破的標的按強度排名 |

### 連線（MCP 用戶端）

```
https://neeenja--alphabook-breakout-pattern.apify.actor/mcp
Authorization: Bearer <APIFY_TOKEN>
```

發送 JSON-RPC：`initialize`、`tools/list`、`tools/call`。範例：

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "detect_breakout", "arguments": { "code": "600519" } }
}
```

### 計費

按事件付費。`initialize` 與 `tools/list` 免費。每次分析呼叫 **$0.02**；籃子突破掃描（`rank_breakout`）為 **$0.05**，因其最多掃描 10 檔標的。

### 資料來源與誠實邊界

- **K 線：** 騰訊 `gtimg.cn`（A/港/美）與 Yahoo（全球），免費、無需 Key。
- 資料缺失 → 回傳 `n/a`，絕不編造 `0`。
- 所有輸出均附 `NOT_ADVICE` 免責聲明。

# Actor input Schema

## Actor input object example

```json
{}
```

# Actor output Schema

## `mcpEndpoint` (type: `string`):

Streamable HTTP MCP endpoint of this Actor run. Connect an MCP client here (Authorization: Bearer \<APIFY_TOKEN>). POST JSON-RPC messages: initialize, tools/list, tools/call.

## `tools` (type: `string`):

Comma-separated list of the 5 tools: detect_breakout, get_pivot_levels, detect_candlestick_pattern, get_volatility_breakout, rank_breakout.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("neeenja/alphabook-breakout-pattern").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("neeenja/alphabook-breakout-pattern").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{}' |
apify call neeenja/alphabook-breakout-pattern --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,neeenja/alphabook-breakout-pattern"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/M0nVb0HyF51hsBFi4/builds/jWsY50b6F0XsUWKmD/openapi.json