@fre4x/yahoo-finance 1.0.40 → 1.0.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE CHANGED
@@ -1,22 +1,22 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 AlexYoung (Original Author)
4
- Copyright (c) 2026 SKTelecom (Fork Maintainer - Pagination & Caching Enhancements)
5
-
6
- Permission is hereby granted, free of charge, to any person obtaining a copy
7
- of this software and associated documentation files (the "Software"), to deal
8
- in the Software without restriction, including without limitation the rights
9
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
- copies of the Software, and to permit persons to whom the Software is
11
- furnished to do so, subject to the following conditions:
12
-
13
- The above copyright notice and this permission notice shall be included in all
14
- copies or substantial portions of the Software.
15
-
16
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2025 AlexYoung (Original Author)
4
+ Copyright (c) 2026 SKTelecom (Fork Maintainer - Pagination & Caching Enhancements)
5
+
6
+ Permission is hereby granted, free of charge, to any person obtaining a copy
7
+ of this software and associated documentation files (the "Software"), to deal
8
+ in the Software without restriction, including without limitation the rights
9
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10
+ copies of the Software, and to permit persons to whom the Software is
11
+ furnished to do so, subject to the following conditions:
12
+
13
+ The above copyright notice and this permission notice shall be included in all
14
+ copies or substantial portions of the Software.
15
+
16
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22
+ SOFTWARE.
package/README.md CHANGED
@@ -1,74 +1,74 @@
1
- # yahoo-finance — The Market Claw
2
-
3
- > *Markets are not fair. They are fast. The agent that reads prices, filings, and options chains in milliseconds does not lose. It waits.*
4
-
5
- Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.
6
-
7
- Price history, balance sheets, insider moves, analyst upgrades, options flow — the full operational picture of any publicly traded entity. No API key. No subscription. No delay that matters. This B1TE bites through the noisiest market on earth.
8
-
9
- ## Tools
10
-
11
- ### Price & Market Data
12
-
13
- | Tool | What it tracks |
14
- |------|---------------|
15
- | `yfin_get_historical_prices` | OHLCV bars — any ticker, any period, any interval |
16
- | `yfin_get_stock_info` | Price, company profile, key statistics, financial health |
17
- | `yfin_get_news` | Latest news articles for a ticker |
18
- | `yfin_get_stock_actions` | Dividend payments and stock splits |
19
-
20
- ### Financial Statements
21
-
22
- | Tool | What it exposes |
23
- |------|----------------|
24
- | `yfin_get_financial_statement` | Income statement, balance sheet, cash flow (annual or quarterly) |
25
- | `yfin_get_holder_info` | Major holders, institutions, mutual funds, insider transactions |
26
-
27
- ### Options Intelligence
28
-
29
- | Tool | What it maps |
30
- |------|-------------|
31
- | `yfin_get_option_dates` | Available expiration dates for a ticker |
32
- | `yfin_get_option_chain` | Full calls or puts chain for a given expiration |
33
-
34
- ### Analyst Signal
35
-
36
- | Tool | What it surfaces |
37
- |------|----------------|
38
- | `yfin_get_recommendations` | Consensus recommendations or firm upgrade/downgrade history |
39
-
40
- All list tools support pagination via `limit` / `offset`. No API key required.
41
-
42
- ## Mock Mode
43
-
44
- Run without any API key (returns fixture data of identical shape):
45
-
46
- ```bash
47
- MOCK=true npx @fre4x/yahoo-finance
48
- ```
49
-
50
- ## Deploy
51
-
52
- ```json
53
- {
54
- "mcpServers": {
55
- "yahoo-finance": {
56
- "command": "npx",
57
- "args": ["-y", "@fre4x/yahoo-finance"]
58
- }
59
- }
60
- }
61
- ```
62
-
63
- ## Development
64
-
65
- ```bash
66
- npm install
67
- npm run dev # tsx, no build
68
- npm run build # esbuild → dist/
69
- npm test # vitest unit tests
70
- ```
71
-
72
- ## License
73
-
74
- MIT — **WE ARE THE FRE4X.**
1
+ # yahoo-finance — The Market Claw
2
+
3
+ > *Markets are not fair. They are fast. The agent that reads prices, filings, and options chains in milliseconds does not lose. It waits.*
4
+
5
+ Part of **[FRE4X-B1TE](../)** — a monorepo of MCP servers built for autonomous agents.
6
+
7
+ Price history, balance sheets, insider moves, analyst upgrades, options flow — the full operational picture of any publicly traded entity. No API key. No subscription. No delay that matters. This B1TE bites through the noisiest market on earth.
8
+
9
+ ## Tools
10
+
11
+ ### Price & Market Data
12
+
13
+ | Tool | What it tracks |
14
+ |------|---------------|
15
+ | `yfin_get_historical_prices` | OHLCV bars — any ticker, any period, any interval |
16
+ | `yfin_get_stock_info` | Price, company profile, key statistics, financial health |
17
+ | `yfin_get_news` | Latest news articles for a ticker |
18
+ | `yfin_get_stock_actions` | Dividend payments and stock splits |
19
+
20
+ ### Financial Statements
21
+
22
+ | Tool | What it exposes |
23
+ |------|----------------|
24
+ | `yfin_get_financial_statement` | Income statement, balance sheet, cash flow (annual or quarterly) |
25
+ | `yfin_get_holder_info` | Major holders, institutions, mutual funds, insider transactions |
26
+
27
+ ### Options Intelligence
28
+
29
+ | Tool | What it maps |
30
+ |------|-------------|
31
+ | `yfin_get_option_dates` | Available expiration dates for a ticker |
32
+ | `yfin_get_option_chain` | Full calls or puts chain for a given expiration |
33
+
34
+ ### Analyst Signal
35
+
36
+ | Tool | What it surfaces |
37
+ |------|----------------|
38
+ | `yfin_get_recommendations` | Consensus recommendations or firm upgrade/downgrade history |
39
+
40
+ All list tools support pagination via `limit` / `offset`. No API key required.
41
+
42
+ ## Mock Mode
43
+
44
+ Run without any API key (returns fixture data of identical shape):
45
+
46
+ ```bash
47
+ MOCK=true npx @fre4x/yahoo-finance
48
+ ```
49
+
50
+ ## Deploy
51
+
52
+ ```json
53
+ {
54
+ "mcpServers": {
55
+ "yahoo-finance": {
56
+ "command": "npx",
57
+ "args": ["-y", "@fre4x/yahoo-finance"]
58
+ }
59
+ }
60
+ }
61
+ ```
62
+
63
+ ## Development
64
+
65
+ ```bash
66
+ npm install
67
+ npm run dev # tsx, no build
68
+ npm run build # esbuild → dist/
69
+ npm test # vitest unit tests
70
+ ```
71
+
72
+ ## License
73
+
74
+ MIT — **WE ARE THE FRE4X.**