SkilloptionalHermes Optional Skills

Stocks

Name: Stocks
Author: Mibay (Mibayy), Hermes Agent

Stocks: مهارة ينشرها Mibay (Mibayy), Hermes Agent. مجالها البحث وجمع المصادر. يوفّر السجل أمر تثبيت جاهزًا يظهر في هذه الصفحة. الرخصة MIT. الإصدار الموثّق 0.1.0. تُفعَّل بأمر `hermes skills install stocks` بعد مراجعة ما تطلبه. تدعم: linux، macos، windows.

StocksFinanceMarketCryptoInvestingOptionalHermes skill

آخر تحقق من السجل2026-08-18v0.1.0Mibay (Mibayy), Hermes Agent

افتح المصدر الأصلي ↗Read in English

المعنى ببساطة

ماذا يضيف إلى Hermes؟

Stocks: مهارة ينشرها Mibay (Mibayy), Hermes Agent. مجالها البحث وجمع المصادر. يوفّر السجل أمر تثبيت جاهزًا يظهر في هذه الصفحة. الرخصة MIT. الإصدار الموثّق 0.1.0. تُفعَّل بأمر hermes skills install stocks بعد مراجعة ما تطلبه. تدعم: linux، macos، windows.

Stocks هي مهارة مرتبطة بمجال البحث والمصادر. يضيف للوكيل طريقًا للعثور على معلومات ومصادر خارجية بدل الاعتماد على ذاكرة النموذج وحدها.

هذا تفسير مبسّط مبني على وصف الناشر. أبقينا الوصف الإنجليزي بجانبه حتى تستطيع مقارنة المعنى بالمصدر.

استخدمه عندما

استخدمه عندما يكون هدفك واضحًا في البحث والمصادر وتستطيع تحديد البيانات والأفعال التي يحتاجها فقط.

لا تحتاجه عندما

لا تضفه لمجرد التجربة إذا كان لديك طريق أبسط داخل Hermes، أو إذا لم تستطع مراجعة المصدر والصلاحيات.

لمن يناسب؟

مناسب لمن يريد طريقة عمل قابلة للتكرار داخل Hermes.

أول اختبار آمن

اطلب حقيقة حديثة مع مصدرين، وافتح الرابطين وتحقق من تاريخ النشر ومن أن النص يدعم الادعاء.

الوصف الأصلي من الناشر، من دون ترجمة تغيّر المعنى

Stock quotes, history, search, compare, crypto via Yahoo

✓

مصدر البيانات

فُهرس هذا الإدخال من Hermes Optional Skills. الشرح العربي يفسّر النوع والمجال ولا يضيف وظيفة غير مذكورة في المصدر.

مراجعة الأمان

المصدر رسمي أو خضع لمراجعة تحريرية، لكن ذلك لا يغني عن مراجعة الصلاحيات والإصدار.

مسار تثبيت آمن

افحص، ثبّت، ثم اختبر.

01
افتح المصدر
طابق اسم الناشر والرخصة والوصف مع حاجتك، وراجع آخر تحديث فعلي.
02
راجع الصلاحيات والأسرار
لا تلصق قيمة سر داخل الموقع. استخدم أسماء متغيرات البيئة وامنح أقل نطاق ممكن.
03
انسخ الإعداد فقط بعد المراجعة
الأزرار أدناه تنسخ نصًا إلى الحافظة ولا تشغّل أمرًا على جهازك.
04
اختبر بمهمة غير حساسة
تحقق من الأدوات الظاهرة، ثم استبعد أدوات الكتابة أو الحذف التي لا تحتاجها.

أمر التثبيت

راجع الأمر ثم انسخه.

hermes skills install stocks

لا ينفّذ Hermes بالعربي هذا الأمر. التثبيت يحدث داخل جهازك ويظل خاضعًا لفحص Hermes ومراجعتك.

تعريف المهارة كاملًا

ما الذي يحمّله Hermes بالضبط عند تشغيل هذه المهارة.

منقول من التوثيق الرسمي. اقرأه قبل تفعيل المهارة، فهذا النص يصبح تعليمات الوكيل نفسه.

Stock quotes, history, search, compare, crypto via Yahoo.

Skill metadata

جدول مرجعي. لا تقرأه كله، ابحث عن السطر الذي يخصّك فقط.

Source	Optional — install with `hermes skills install official/finance/stocks`
Path	`optional-skills/finance/stocks`
Version	`0.1.0`
Author	Mibay (Mibayy), Hermes Agent
License	MIT
Platforms	linux, macos, windows
Tags	`Stocks`, `Finance`, `Market`, `Crypto`, `Investing`
Related skills	`dcf-model`, `comps-analysis`, `lbo-model`

Reference: full SKILL.md

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه.

Read-only market data via Yahoo Finance. Five commands: quote, search, history, compare, crypto. Python stdlib only — no API key, no pip installs. Yahoo's endpoint is unofficial and may rate-limit or change.

When to Use

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه.

User asks for a current stock price (AAPL, TSLA, MSFT, ...)
User wants to look up a ticker by company name
User wants OHLCV history or performance over a date range
User wants to compare several tickers side by side
User asks for a crypto price (BTC, ETH, SOL, ...)

Prerequisites

إعدادات تضبطها مرة وتنساها. غيّر واحدًا في كل مرة حتى تعرف أثر كل تغيير. تضبط ALPHA_VANTAGE_KEY خارج المحادثة، في بيئة التشغيل.

Python 3.8+ stdlib only. Optional: set ALPHA_VANTAGE_KEY to enrich market_cap, pe_ratio, and 52-week levels when Yahoo's crumb-protected fields come back null. Free key: https://www.alphavantage.co/support/#api-key

How to Run

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه.

Invoke through the terminal tool. Once installed:

Textسطران

SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py
python3 $SCRIPT quote AAPL

All output is JSON on stdout — pipe through jq if you want to slice it.

Quick Reference

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه.

Text6 أسطر

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

Commands

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه.

`quote SYMBOL [SYMBOL2 ...]`

Current price, change, change%, volume, 52-week high/low.

`search QUERY`

Find tickers by company name. Returns top 5: symbol, name, exchange, type.

`history SYMBOL [--range RANGE]`

Daily OHLCV plus stats (min, max, avg, total return %). Ranges: 1mo, 3mo, 6mo, 1y, 5y. Default: 1mo.

`compare SYMBOL1 SYMBOL2 [...]`

Side-by-side: price, change%, 52-week performance.

`crypto SYMBOL [SYMBOL2 ...]`

Crypto prices. Pass BTC (the script appends -USD automatically).

Pitfalls

Yahoo Finance's API is unofficial. Endpoints can change or rate-limit without notice — if requests start failing, that's why.
market_cap and pe_ratio may return null on quote when Yahoo's crumb session isn't established. Set ALPHA_VANTAGE_KEY to backfill.
Add a small delay between bulk requests to avoid rate-limiting.
This is read-only — no order placement, no account integration.

Verification

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه.

Textسطر واحد

python3 ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL

Returns a JSON object with symbol: "AAPL" and a numeric price field.