AI முகவர்களுக்கான FinancialMD
FinancialMD என்பது முகவர்களுக்கான AI-native நிதி டெர்மினல். இது SEC தாக்கல்களில் இருந்து உருவாக்கப்பட்ட நிதி அறிக்கைகளை வழங்குகிறது. ஒவ்வொரு எண்ணும் தாக்கலுக்குத் திரும்பிச் செல்லும் சான்றை கொண்டுள்ளது, மேலும் ஒவ்வொரு வாசிப்பும் கடந்த தேதியின் நிலவரப்படி செய்ய முடியும்; ஆகவே ஒரு முகவர் தாம் சொல்வதை மேற்கோள் காட்டவும், look-ahead இல்லாமல் backtest செய்யவும் முடியும்.
படி 1. MCP சேவையகத்தை இணைக்கவும்
MCP சேவையகம் https://mcp.financial.md/mcp இல் உள்ளது (ஸ்ட்ரீமபிள் HTTP, நாடற்றது). இதில் 57 படிக்க மட்டுமே கருவிகள் உள்ளன. உள்நுழைவது விருப்பமானது: டோக்கன் இல்லாமல் அது விசையில்லா தினசரி வரம்புகளுக்குள் பதிலளிக்கிறது.
கிளாட் குறியீடு:
claude mcp add --transport http financial-md https://mcp.financial.md/mcpJSON config-ஐப் படிக்கும் clients (Cursor, VS Code, Windsurf மற்றும் பிற):
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}Claude அல்லது ChatGPT-இல், அதே URL-ஐ custom connector ஆகச் சேர்க்கவும். server card mcp.financial.md/.well-known/mcp.json இல் உள்ளது, மற்றும் OAuth metadata mcp.financial.md/.well-known/oauth-protected-resource இல் உள்ளது.
company_lookup மூலம் தொடங்கவும், பின்னர் snapshot_as_of (ஒரே அழைப்பில், ஒரு தேதியில் அறியப்பட்ட மூன்று அறிக்கைகளும் விகிதங்களும்) அல்லது financials_standardized பயன்படுத்தவும். நீங்கள் வேறு எங்காவது கண்ட எண்ணைச் சரிபார்க்க verify_value பயன்படுத்தவும்.
படி 2. விசையில்லா API அழைப்பை மேற்கொள்ளவும்
HTTP API-க்கு கணக்கும் கீயும் தேவையில்லை. இந்த அழைப்பு Apple இன் கடந்த ஐந்து ஆண்டு பணப்புழக்க அறிக்கைகளை, தடையற்ற பணப்புழக்கம் உட்பட, திருப்பித் தருகிறது:
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"ஒவ்வொரு எண்ணும் proof.accession, proof.form, proof.filed மற்றும் proof.source_url (sec.gov-இல் உள்ள தாக்கல்) கொண்ட ஒரு value object ஆகும். அந்த தேதியில் அறியப்பட்டதைப் படிக்க as_of=2024-06-30 ஐச் சேர்க்கவும். ஒரு எண்ணை தாக்கலுடன் ஒப்பிட்டு சரிபார்க்கவும்:
curl -X POST "https://api.financial.md/v1/verify" -H "content-type: application/json" \
-d '{"company":"ticker:AAPL","concept":"income_statement_total_revenues","period":"FY2024","value":391035000000}'விசை இல்லாமல், ஒவ்வொரு IP முகவரிக்கும் ஒரு நாளுக்கு 10 மீட்டர் செய்யப்பட்ட அழைப்புகள் (விகிதங்கள், திரை, சரிபார்ப்பு), 1,000 தாக்கல்-அடுக்கு வாசிப்புகள் மற்றும் 1,000 மெட்டாடேட்டா வாசிப்புகள் கிடைக்கும். ஒவ்வொரு பதிலும் RateLimit-* தலைப்புகளைக் கொண்டுள்ளது; 429 பதிலில் Retry-After இருக்கும், மேலும் ஒவ்வொரு பிழை உடலும் தீர்வுகளைப் பட்டியலிடும்.
படி 3. ஒரு அழைப்புக்கு பணம் செலுத்துங்கள்
agent.financial.md கணக்கு இல்லாமல் x402 (Base இல் USDC) மூலம் ஒரு அழைப்புக்கு பணம் செலுத்தும் முகவர்களுக்கு அதே பாதைகளை வழங்குகிறது. அங்குள்ள விலை நிர்ணயிக்கப்பட்ட பாதை PAYMENT-REQUIRED தலைப்பில் விலையுடன் 402 ஆக பதிலளிக்கிறது; கட்டணத்தில் கையொப்பமிட்டு PAYMENT-SIGNATURE தலைப்புடன் அழைப்பை மீண்டும் அனுப்பவும். 402 இன் உடல் விசையில்லா ஹோஸ்டையும் குறிப்பிடுகிறது, அங்கு அதே பாதை தினசரி வரம்புகளுக்குள் ஒருபோதும் கட்டணம் வசூலிக்கப்படுவதில்லை.
ஒவ்வொரு பாதையின் விலையும் pricing.json மற்றும் OpenAPI ஆவணத்தின் `x-price` புலத்தில் உள்ளது. 402 பதிலில் உள்ள விலை பொருந்தும். தோல்வியடைந்த அழைப்பு கட்டணம் வசூலிக்கப்படாது.
முகவர்களுக்கான கோப்புகள்
| கோப்பு | அது என்ன |
|---|---|
| openapi.json | OpenAPI 3.1. ஒவ்வொரு செயல்பாட்டிற்கும் ஒரு விளக்கம் மற்றும் உண்மையான டிக்கருடன் ஒரு உதாரண கோரிக்கை உள்ளது |
| llms.txt | சுருக்கமான வழிகாட்டி: ஹோஸ்ட்கள், நிறுவனம் id-கள், value object, குறிப்பிட்ட நேரப்புள்ளி (point-in-time) வாசிப்புகள், வரம்புகள் |
| llms-full.txt | ஒரே உரைக் கோப்பில் அனைத்தும்: ஒவ்வொரு பாதையும், விகித சூத்திரமும், செய்முறையும் |
| skill.md | ஒரு-அழைப்பு செய்முறைகளைக் கொண்ட ஒரு Agent Skill |
| skills.zip | MCP கருவிகளை அழைக்கும் Agent Skills (SKILL.md), ஒரே zip ஆக |
| pricing.json | ஒரு-அழைப்புக்கான விலைகள், தினசரி வரம்புகள் மற்றும் கட்டண நிலை |
| mcp.json | MCP சேவையக அட்டை: கருவிகள், அங்கீகாரம் மற்றும் ஆவணங்கள் |
| server.json | MCP பதிவேட்டில் உள்ளீடு |
| agent.json | மேலே உள்ள ஒவ்வொரு endpoint மற்றும் ஆவணத்திற்குமான ஒரு குறியீடு |
ஒரு முகவர் எதை நம்பலாம்
- ஒவ்வொரு எண்ணுக்கும் ஒரு மூலம் உள்ளது: தாக்கலின் accession number, form, filing date, XBRL tag மற்றும் sec.gov இல் உள்ள ஆவணத்திற்கான இணைப்பு.
GET /proof/{id}அதற்குப் பின்னுள்ள மூல உண்மைகளை காட்டுகிறது. - குறிப்பிட்ட நேரப்புள்ளி (point-in-time): ஒவ்வொரு மதிப்பும் சமீபத்திய தாக்கல் செய்யப்பட்ட எண்ணாக இருந்த காலத்தை
known.fromமற்றும்known.toகூறுகின்றன.as_of,original=trueமற்றும்history=trueமுன்னோக்கிப் பார்ப்பதின்றி கடந்த காலத்தை வாசித்து, திருத்தியமைக்கப்பட்ட எண்ணிக்கைகளையும் காட்டுகின்றன. - குறுகிய பதில்கள்: ஒரு அறிக்கை அழைப்பு கேட்கப்பட்ட காலங்களை மட்டுமே வழங்குகிறது; MCP கருவி முடிவுகள் கட்டமைக்கப்பட்ட தரவுக்கு முன் ஒரு வரி சுருக்கத்துடன் தொடங்குகின்றன.
- டிக்கர், CIK அல்லது பெயர்:
company=ticker:AAPL,company=cik:320193, அல்லதுGET /v1/companies?q=Apple. - கவரேஜ்: இன்று US பரிமாற்றத்தில் பட்டியலிடப்பட்ட SEC தாக்கல் செய்பவர்கள்; US GAAP தாக்கல் செய்பவர்களுக்கான தரநிலைப்படுத்தப்பட்ட அறிக்கைகள். தகவலுக்காக மட்டுமே, முதலீட்டு ஆலோசனை அல்ல.