Chuyển tới nội dung chính

{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}

cổ phiếu

Báo giá chứng khoán, lịch sử, tìm kiếm, so sánh, tiền điện tử qua Yahoo.

Siêu dữ liệu kỹ năng​

NguồnTùy chọn — cài đặt với
`Hermes skills install official/finance/stocks
`
Đường dẫn

optional-skills/finance/stocks ` | | Phiên bản |

0.1.0 ` | | Tác giả | Mibay (Mibayy), Đại lý Hermes | | Giấy phép | MIT | | Nền tảng | Linux, macOS, Windows | | Thẻ |

Stocks

, `Finance

, `Market

, `Crypto

, Investing | | Kỹ năng liên quan | XPROTECTX11XPROTECTX, XPROTECTX12XPROTECTX, XPROTECTX13XPROTECTX |

Tham khảo: đầy đủ SKILL.md​

thông tin

Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.

Kỹ năng chứng khoán

Dữ liệu thị trường chỉ đọc qua Yahoo Finance. Năm lệnh: `quote

, `search

, `history

, `compare

, `crypto

. Chỉ Python stdlib - không có khóa API, không có pip cài đặt. Điểm cuối của Yahoo không chính thức và có thể giới hạn tỷ lệ hoặc thay đổi.

Khi nào nên sử dụng​

  • Người dùng hỏi giá cổ phiếu hiện tại (AAPL, TSLA, MSFT, ...)
  • Người dùng muốn tra cứu mã chứng khoán theo tên công ty
  • Người dùng muốn lịch sử hoặc hiệu suất OHLCV trong một phạm vi ngày
  • Người dùng muốn so sánh nhiều mã cạnh nhau
  • Người dùng yêu cầu giá tiền điện tử (BTC, ETH, SOL, ...)

Điều kiện tiên quyết​

Chỉ có Python 3.8+ stdlib. Tùy chọn: đặt ALPHA_VANTAGE_KEY để làm phong phú `market_cap

, pe_ratio và các cấp độ 52 tuần khi được bảo vệ khỏi mảnh vụn của Yahoo các trường trở lại rỗng. Khóa miễn phí: https://www.alphavantage.co/support/#API-key

Cách chạy​

Gọi thông qua công cụ `terminal

. Sau khi cài đặt:

` SCRIPT=~/.Hermes/skills/finance/stocks/scripts/stocks_CLIent.py Python3 $SCRIPT quote AAPL

``Tất cả đầu ra đều là JSON trên thiết bị xuất chuẩn - chuyển qua jq ` nếu bạn muốn cắt nó.

Tham khảo nhanh​

` Python3 $SCRIPT quote AAPL Python3 $SCRIPT quote AAPL MSFT GOOGL TSLA Python3 $SCRIPT search "Tesla" Python3 $SCRIPT history NVDA --range 6mo Python3 $SCRIPT compare AAPL MSFT GOOGL Python3 $SCRIPT crypto BTC ETH SOL

`

Lệnh​

`quote SYMBOL [SYMBOL2 ...] ``Giá hiện tại, thay đổi, % thay đổi, khối lượng, mức cao/thấp trong 52 tuần.

​

`search QUERY ``Tìm mã theo tên công ty. Trả về top 5: ký hiệu, tên, trao đổi, loại.

​

history SYMBOL [--range RANGE] ``OHLCV hàng ngày cộng với số liệu thống kê (tối thiểu, tối đa, trung bình, tổng lợi nhuận). Phạm vi: 1mo

, `3mo

, `6mo

, `1y

, `5y

. Mặc định: `1mo

.

​

`compare SYMBOL1 SYMBOL2 [...] ``So sánh: giá,% thay đổi, hiệu suất trong 52 tuần.

​

crypto SYMBOL [SYMBOL2 ...] ``Giá tiền điện tử. Vượt qua BTC ` (tập lệnh tự động thêm

-USD

).

Cạm bẫy​

  • API của Yahoo Finance không chính thức. Điểm cuối có thể thay đổi hoặc giới hạn tốc độ mà không cần thông báo — nếu yêu cầu bắt đầu thất bại, đó là lý do.

market_cap và pe_ratio có thể trả về null trên quote khi Yahoo phiên vụn không được thiết lập. Đặt ALPHA_VANTAGE_KEY để chèn lấp.

  • Thêm độ trễ nhỏ giữa các yêu cầu hàng loạt để tránh giới hạn tốc độ.
  • Đây là chế độ chỉ đọc — không cần đặt hàng, không tích hợp tài khoản.

Xác minh​

` Python3 ~/.Hermes/skills/finance/stocks/scripts/stocks_CLIent.py quote AAPL

``Trả về một đối tượng JSON có symbol: "AAPL" và trường price ` dạng số.