آموزش تحلیل داده‌های مالی با Claude و داده‌های زنده

استفاده از Claude برای تحلیل داده‌های مالی

مدل Claude در خواندن داده‌های مالی و تبیین مفاهیم آن‌ها بسیار توانمند است. با این حال، به دلیل محدودیت داده‌های آموزشی، این مدل از ارقام لحظه‌ای بازار بی‌اطلاع است. راهکار این مسئله ساده است: داده‌های زنده بازار را از طریق یک API در اختیار Claude قرار دهید تا او به وظیفه اصلی خود، یعنی تحلیل، مقایسه و ارائه توضیحات به زبان ساده، بپردازد.

این راهنما به شما نشان می‌دهد که چگونه با استفاده از یک API رایگان داده‌های بازار، در سه روش مختلف، Claude را به آن متصل کنید. همچنین پرامپت‌های عملیاتی برای کپی‌برداری در اختیار شما قرار گرفته است. شفاف‌سازی: این API متعلق به Strasmore است که توسط تیم ما توسعه یافته است. استفاده از آن نیازی به ایجاد حساب کاربری ندارد، بنابراین می‌توانید تمام مراحل این راهنما را در 5 دقیقه آینده امتحان کنید.

پیش‌نیازها و نحوه عملکرد

برای شروع، نیازی به ثبت‌نام یا دریافت کلید API ندارید. Strasmore به گونه‌ای طراحی شده است که دسترسی به داده‌های مالی را برای تحلیل‌گران و توسعه‌دهندگان تسهیل کند.

• داده‌های زنده: دسترسی به قیمت‌های لحظه‌ای سهام و شاخص‌ها.
• بدون احراز هویت: استفاده مستقیم از URLها بدون نیاز به مدیریت کلیدهای امنیتی.
• سازگاری: خروجی‌های JSON که برای مدل‌های زبانی (LLM) بهینه‌سازی شده‌اند.

روش‌های اتصال Claude به داده‌های بازار

شما می‌توانید از روش‌های زیر برای تغذیه داده‌ها به Claude استفاده کنید:

1. کپی و پیست دستی: ساده‌ترین روش برای تحلیل‌های موردی.
2. استفاده از قابلیت Web Browsing: اگر نسخه Claude شما به اینترنت دسترسی دارد، می‌توانید مستقیماً لینک API را به آن بدهید.
3. اتصال از طریق ابزارهای اتوماسیون: استفاده از اسکریپت‌های پایتون برای دریافت داده و ارسال آن به API مدل Claude.

پرامپت‌های نمونه برای تحلیل

برای دریافت بهترین نتیجه، از پرامپت‌های زیر استفاده کنید:

"داده‌های مالی زیر را که از API دریافت شده است، تحلیل کن. روند قیمت را در 24 ساعت گذشته بررسی کن و بگو آیا نشانه‌ای از نوسان غیرعادی وجود دارد یا خیر؟"

"این داده‌های JSON را به یک جدول خوانا تبدیل کن و خلاصه‌ای از وضعیت عملکرد این دارایی در مقایسه با شاخص کل ارائه بده."

FAQ

آیا استفاده از این API محدودیت تعداد درخواست دارد؟

خیر، در حال حاضر هیچ محدودیتی برای استفاده از API در این راهنما وجود ندارد.

آیا داده‌ها برای تحلیل‌های معاملاتی دقیق هستند؟

این داده‌ها برای تحلیل‌های آموزشی و بررسی‌های کلی مناسب هستند، اما برای معاملات الگوریتمی با فرکانس بالا توصیه نمی‌شوند.

اگر API در دسترس نباشد چه باید کرد؟

ابتدا وضعیت اتصال اینترنت خود را بررسی کنید و سپس با استفاده از curl -I <URL> در ترمینال، وضعیت پاسخ‌دهی سرور را کنترل نمایید.

چرا Claude به منبع داده نیاز دارد

اگر از Claude بپرسید «نرخ سود سهام مایکروسافت در حال حاضر چقدر است» و هیچ ابزاری به آن متصل نباشد، با یکی از دو حالت شکست مواجه می‌شوید. یا درخواست شما را رد می‌کند، یا بر اساس داده‌های آموزشی که مربوط به ماه‌ها پیش است پاسخ می‌دهد. هر دو حالت به این دلیل رخ می‌دهند که مدل به قیمت‌های فعلی دسترسی ندارد. این مدل نمی‌تواند به‌تنهایی هیچ اطلاعاتی را جستجو کند.

با اتصال یک منبع داده، وضعیت کاملاً تغییر می‌کند. Claude به‌راحتی JSON را می‌خواند، ده‌ها ردیف داده را بدون گم کردن مسیر در context حفظ می‌کند و با کمال میل آنچه را که داده‌ها واقعاً نشان می‌دهند، مقایسه، رتبه‌بندی و خلاصه‌سازی می‌کند. اکنون کیفیت پاسخ به کیفیت داده‌ای بستگی دارد که در اختیار آن قرار می‌دهید.

یک API رایگان داده‌های بازار بدون نیاز به کلید

نسخه نمایشی API شرکت Strasmore، مجموعه‌ای از کوئری‌های ثابت روی داده‌های سهام و آپشن‌های بازار آمریکا را به صورت JSON ساده ارائه می‌دهد. برای استفاده از آن نیازی به ثبت‌نام، کلید API یا درگیری با محدودیت‌های نرخ (rate-limit) نیست. مرجع کامل endpointها در مستندات API موجود است؛ خلاصه آن به شرح زیر است:

# What queries exist? (start here)
curl "https://ai.strasmore.com/api/demo/catalog"

# The highest large-cap dividend yields right now
curl "https://ai.strasmore.com/api/demo?q=dividend_yield_leaders"

# Implied-volatility leaders in the options market
curl "https://ai.strasmore.com/api/demo?q=iv_leaders"

# The latest market headlines with tickers
curl "https://ai.strasmore.com/api/demo?q=latest_market_news"

هر پاسخ شامل ردیف‌ها، نام ستون‌ها و کد SQL دقیقی است که اعداد را تولید کرده است. بخش آخر برای کارهای مبتنی بر هوش مصنوعی اهمیت دارد: شما می‌توانید کد SQL را به همراه داده‌ها به Claude نشان دهید تا علاوه بر نتیجه، کوئری را نیز برای شما تحلیل و تشریح کند.

قیمت‌ها با تأخیر همراه هستند و مقادیر یونانی (greeks) آپشن‌ها مربوط به پایان روز معاملاتی است. برای یادگیری، غربالگری و جریان‌های کاری تحلیل، این دقیقاً همان چیزی است که نیاز دارید. این یک فید معاملاتی نیست و این راهنما نیز بر تحلیل تمرکز دارد، نه اجرای معاملات.

روش 1: جای‌گذاری JSON در چت

سریع‌ترین روش بدون نیاز به تنظیمات. یک دستور curl اجرا کنید، خروجی JSON را کپی کرده و آن را به همراه یک دستورالعمل شفاف در چت Claude جای‌گذاری کنید. این روش در وب‌اپلیکیشن claude.ai، نسخه دسکتاپ یا هر رابط کاربری چت دیگری کار می‌کند.

ساختار پرامپتی که به‌خوبی عمل می‌کند:

Here is JSON from a market data API. The `sql` field shows exactly
how the numbers were computed.

[paste the JSON here]

1. Summarize what this data shows in plain English.
2. Which three rows stand out, and what makes them unusual?
3. What would you want to check next before drawing conclusions?

سوال سوم از اهمیت بالایی برخوردار است. این سوال Claude را وادار می‌کند تا به‌جای حدس‌زدن‌های غیردقیق، محدودیت‌های داده‌ها را مشخص کند. پیشنهادهای او (مانند «بررسی تاریخچه پرداخت‌ها» یا «مقایسه با بخش مربوطه») اغلب پرسش‌های بعدی بسیار بهتری نسبت به آنچه شما به‌صورت بداهه می‌نوشتید، ایجاد می‌کنند.

روش 2: اجازه دهید Claude Code داده‌ها را خودش دریافت کند

اگر از Claude Code استفاده می‌کنید، می‌توانید کپی-پیست کردن را به‌طور کامل کنار بگذارید، زیرا Claude Code می‌تواند دستور curl را به‌صورت مستقل اجرا کند. از آن سوال بپرسید و به آن بگویید داده‌ها کجا قرار دارند:

Fetch https://ai.strasmore.com/api/demo/catalog, pick the query that
best answers this question, fetch it, and analyze the result:
which large-cap stocks pay the highest dividend yields right now,
and how do their P/E ratios compare?

Claude Code کاتالوگ را می‌خواند، dividend_yield_leaders را انتخاب می‌کند، آن را دریافت کرده و با ردیف‌های واقعی کار می‌کند. از آنجا که حلقهٔ عامل (agent loop) روی دستگاه شما اجرا می‌شود، این قابلیت با سایر ابزارهای موجود در سیستم شما نیز ترکیب می‌شود: می‌تواند نتایج را در فایل‌ها ذخیره کند، با یک اسکریپت Python نمودار رسم کند، یا خروجی امروز صفحه را با آنچه هفتهٔ گذشته ذخیره کرده است مقایسه (diff) کند. یک هزینه که باید به آن توجه داشت: هر payload با فرمت JSON که عامل دریافت می‌کند در گفتگو باقی می‌ماند و در نوبت بعدی دوباره ارسال می‌شود، که این دلیل گران شدن جلسات طولانی Claude Code است.

یک سرور لینوکسی که همیشه روشن است، بهترین محیط برای این گردش‌کار است. یک حلقهٔ روزانه برای «دریافت صفحات، مقایسه با دیروز، و نوشتن خلاصه» به دستگاهی نیاز دارد که هرگز به خواب نرود. ما یک راهنمای کامل برای اجرای Claude Code روی VPS با استفاده از tmux داریم تا جلسات پس از قطع اتصال SSH همچنان فعال باقی بمانند. اگر این مسیر را انتخاب کردید، ابتدا راهنمای ما برای اجرای ایمن عامل‌های هوش مصنوعی روی VPS را مطالعه کنید؛ عاملی که به shell دسترسی دارد، نیازمند تدابیر حفاظتی جدی است.

روش 3: استفاده از Claude API با ابزار fetch

برای نرم‌افزاری که در حال توسعه آن هستید، API را به عنوان یک ابزار (tool) در اختیار Claude قرار دهید. با استفاده از Python SDK شرکت Anthropic، کل پیاده‌سازی شامل یک تعریف ابزار و یک تابع fetch است:

import json, urllib.request
import anthropic

def fetch_demo(query_key: str) -> str:
    url = f"https://ai.strasmore.com/api/demo?q={query_key}"
    with urllib.request.urlopen(url, timeout=30) as r:
        return r.read().decode()

client = anthropic.Anthropic()
tools = [{
    "name": "fetch_market_data",
    "description": "Fetch a fixed market-data query. Keys are listed at "
                   "https://ai.strasmore.com/api/demo/catalog e.g. "
                   "dividend_yield_leaders, iv_leaders, latest_market_news.",
    "input_schema": {
        "type": "object",
        "properties": {"query_key": {"type": "string"}},
        "required": ["query_key"],
    },
}]

# Claude decides when to call the tool; your loop executes fetch_demo()
# and returns the JSON as the tool result. See Anthropic's tool-use docs.

هنگامی که پرسشی نیاز به داده داشته باشد، Claude ابزار را فراخوانی می‌کند؛ شما عملیات fetch را اجرا کرده و خروجی JSON را بازمی‌گردانید تا مدل به جای تکیه بر حافظه، بر اساس ردیف‌های واقعی داده پاسخ دهد. کلاینت، کلید شما را از محیط (environment) دریافت می‌کند؛ بنابراین اگر این کد قرار است روی یک سرور یا زیرساخت ابری اجرا شود، پیش از هرگونه hardcode کردن، نحوه احراز هویت کلاینت در آن محیط را بررسی کنید. این تنها روشی است که هزینه را بر اساس توکن محاسبه می‌کند و از اشتراک چت استفاده نمی‌کند؛ بنابراین اگر می‌خواهید بدانید آیا Claude API سطح رایگان دارد، پاسخ کوتاه این است که در زمان ثبت‌نام اعتبار محدودی دریافت می‌کنید و پس از آن هزینه‌ها به صورت مصرفی محاسبه می‌شود. اگر به جای ابزار inline، استفاده از یک سرور قابل استفاده مجدد را ترجیح می‌دهید، همین الگو با Model Context Protocol نیز کار می‌کند؛ راهنمای ما در مورد سرورهای MCP روی VPS نحوه میزبانی آن‌ها را پوشش می‌دهد.

پرامپت‌هایی که تحلیل‌های دقیق ارائه می‌دهند

چند الگو وجود دارد که صرف‌نظر از نحوه اتصال، خروجی را به‌طور مداوم بهبود می‌بخشند:

• از Claude بخواهید ردیف‌ها را ارجاع دهد. «برای هر ادعا، نماد معاملاتی (ticker) و عددی که از آن استخراج شده را ذکر کن.» این کار مانع از ارائه خلاصه‌های مبهم می‌شود.
• درباره محدودیت‌های داده‌ها بپرسید. قیمت‌های با تأخیر، یونانی‌های (greeks) پایان روز و یک اسکرین ثابت همگی محدودیت‌هایی دارند؛ اگر از Claude بپرسید، آن‌ها را به‌وضوح بیان می‌کند و این کار باعث حفظ صداقت در تحلیل می‌شود.
• بخواهید مقایسه کند، نه پیش‌بینی. «کدام‌یک از این بازده‌ها بر اساس نسبت‌های پرداخت (payout ratios) نمایش‌داده‌شده، پایدار به نظر می‌رسند؟» پاسخی مستدل به دست می‌دهد. «کدام سهم رشد خواهد کرد؟» پاسخی حدسی اما خوش‌ساخت دریافت می‌کنید، زیرا پیش‌بینی چیزی نیست که داده‌ها از آن پشتیبانی کنند.
• SQL را در متن نگه دارید. فیلد sql دقیقاً به Claude می‌گوید که یک اسکرین چگونه ساخته شده است؛ بنابراین می‌تواند توضیح دهد که چرا یک نام در لیست نیست (مثلاً به دلیل کف ارزش بازار یا سقف بازدهی) و از ابداع دلایل ساختگی خودداری کند.

زمانی که پرس‌وجوهای ثابت دیگر کافی نیستند

صفحه‌های نمایش در این دمو به‌صورت هدفمند ثابت در نظر گرفته شده‌اند. گام بعدی، استفاده از API پولی Strasmore است: همان انبار داده، شامل 22 سال سابقه سهام ایالات متحده و 12 سال سابقه اختیار معامله، به همراه امکان طرح پرسش‌های اختصاصی شما با استفاده از SQL یا زبان ساده و یک کلید برنامه‌نویسی. گردش کار تغییری نمی‌کند؛ ابزار شما به‌جای نقطه پایانی (endpoint) عمومی، از یک نقطه پایانی احراز هویت‌شده داده‌ها را دریافت می‌کند و تعریف پرسش‌ها در اختیار شما قرار می‌گیرد. مدل Claude در نوشتن SQL برای ClickHouse بر اساس یک طرح‌واره (schema) مستندشده بسیار توانمند است؛ این ویژگی باعث می‌شود وظیفه‌ای مانند «استخراج تاریخچه سود سهام تمام REITها با ارزش بازار بالای 10 میلیارد دلار و رتبه‌بندی آن‌ها بر اساس رشد پنج‌ساله» تنها با یک دستور (prompt) انجام شود.

FAQ

آیا Claude می‌تواند بدون منبع داده، سهام را تحلیل کند؟

با اعداد فعلی خیر. داده‌های آموزشی این مدل پیش از امروز به پایان می‌رسد، بنابراین هر آنچه درباره قیمت‌های فعلی می‌گوید از حافظه قدیمی است. یک API زنده به آن بدهید تا تحلیل بر اساس ردیف‌هایی که به‌تازگی دریافت کرده است، مستند شود.

آیا API دمو Strasmore واقعاً رایگان است؟

بله. بدون نیاز به کلید، ثبت‌نام یا کارت بانکی. این API مجموعه‌ای از پرس‌وجوهای ثابت را روی داده‌های با تأخیر سهام ایالات متحده و داده‌های پایان روز آپشن‌ها ارائه می‌دهد و عمداً برای ایجنت‌های هوش مصنوعی باز گذاشته شده است.

آیا برای این کار به VPS نیاز دارم؟

خیر. گردش کار کپی-پیست فقط به یک مرورگر نیاز دارد. زمانی که بخواهید حلقه ایجنت طبق زمان‌بندی اجرا شود، در برابر قطع اتصال مقاوم باشد و فایل‌های محلی نتایج قبلی را نگه دارد، استفاده از VPS ارزشمند می‌شود.

آیا این مشاوره مالی است؟

خیر. تمام موارد اینجا ابزارهای تحلیل هستند. Claude داده‌ها را خلاصه و مقایسه می‌کند؛ تصمیم‌گیری درباره آنچه با این داده‌ها انجام می‌دهید با شماست و داده‌های آموزشی با تأخیر، مبنایی برای اجرای معاملات نیستند.

یک صفحه نمایش را به یک چت متصل کنید تا بلافاصله تفاوت را ببینید: Claude دیگر درباره اعدادی که نمی‌تواند بداند با اطمینان صحبت نمی‌کند و درباره اعدادی که به آن‌ها دسترسی دارد، شروع به ارائه نتایج مفید می‌کند.