FinancialMD สำหรับ AI agents
FinancialMD คือเทอร์มินัลการเงินแบบ AI-native สำหรับเอเจนต์ ให้บริการงบการเงินที่สร้างจากเอกสารที่ยื่นต่อ SEC ทุกตัวเลขมีหลักฐานย้อนกลับไปยังเอกสารที่ยื่นต่อ SEC และทุกการอ่านสามารถทำได้ ณ วันที่ในอดีต ดังนั้นเอเจนต์จึงสามารถอ้างอิงสิ่งที่พูดและทำ backtest ได้โดยไม่มี look-ahead
ขั้นตอนที่ 1. เชื่อมต่อเซิร์ฟเวอร์ MCP
เซิร์ฟเวอร์ MCP อยู่ที่ https://mcp.financial.md/mcp (Streamable HTTP, stateless) มีเครื่องมือแบบอ่านอย่างเดียว 57 ตัว การลงชื่อเข้าใช้เป็นทางเลือก: หากไม่มีโทเค็น ระบบจะตอบกลับภายในขีดจำกัดรายวันแบบไม่ใช้คีย์
Claude Code:
claude mcp add --transport http financial-md https://mcp.financial.md/mcpไคลเอนต์ที่อ่านการตั้งค่า JSON (Cursor, VS Code, Windsurf และอื่น ๆ):
{
"mcpServers": {
"financial-md": { "type": "http", "url": "https://mcp.financial.md/mcp" }
}
}ใน Claude หรือ ChatGPT ให้เพิ่ม URL เดียวกันเป็นตัวเชื่อมต่อแบบกำหนดเอง server card อยู่ที่ mcp.financial.md/.well-known/mcp.json และ metadata ของ OAuth อยู่ที่ mcp.financial.md/.well-known/oauth-protected-resource.
เริ่มจาก company_lookup, จากนั้น snapshot_as_of (งบทั้งสามฉบับและอัตราส่วนตามที่ทราบ ณ วันนั้น ในการเรียกครั้งเดียว) หรือ financials_standardized ใช้ verify_value เพื่อตรวจสอบตัวเลขที่คุณพบจากที่อื่น
ขั้นตอนที่ 2. เรียก API แบบไม่ใช้คีย์
HTTP API ไม่ต้องใช้บัญชีและไม่ต้องใช้คีย์ การเรียกนี้จะส่งคืนงบกระแสเงินสดประจำปี 5 งวดล่าสุดของ Apple รวมถึงกระแสเงินสดอิสระ:
curl "https://api.financial.md/v1/company/financials/cash_flow/standardized?company=ticker:AAPL&period_type=annual&limit=5"แต่ละตัวเลขเป็น value object ที่มี proof.accession, proof.form, proof.filed และ proof.source_url (เอกสารที่ยื่นต่อ SEC บน sec.gov) เพิ่ม as_of=2024-06-30 เพื่ออ่านสิ่งที่ทราบ ณ วันที่นั้น ตรวจสอบตัวเลขเทียบกับเอกสารที่ยื่นต่อ SEC:
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 address จะได้รับการเรียกแบบคิดตามปริมาณ 10 ครั้งต่อวัน (ratios, screen, verify), การอ่านชั้นเอกสารที่ยื่นต่อ SEC 1,000 ครั้ง และการอ่าน metadata 1,000 ครั้ง ทุกการตอบกลับมีเฮดเดอร์ RateLimit-*; สถานะ 429 จะมี Retry-After และเนื้อหาข้อผิดพลาดทุกครั้งจะแสดงวิธีแก้ไข.
ขั้นตอนที่ 3. จ่ายต่อการเรียก
agent.financial.md ให้บริการเส้นทางเดียวกันสำหรับเอเจนต์ที่จ่ายต่อการเรียกด้วย x402 (USDC บน Base) โดยไม่ต้องมีบัญชี เส้นทางที่มีราคาจะตอบกลับ 402 พร้อมราคาในเฮดเดอร์ PAYMENT-REQUIRED; ลงนามการชำระเงินแล้วส่งคำขอเดิมอีกครั้งพร้อมเฮดเดอร์ PAYMENT-SIGNATURE เนื้อหาของ 402 ยังระบุโฮสต์แบบไม่ใช้คีย์ ซึ่งเส้นทางเดียวกันนั้นไม่มีการเรียกเก็บเงินภายในขีดจำกัดรายวัน.
ราคาของทุกเส้นทางอยู่ใน pricing.json และในฟิลด์ x-price ของเอกสาร OpenAPI document ราคาที่อยู่ในคำตอบ 402 คือราคาที่ใช้บังคับ การเรียกที่ล้มเหลวจะไม่ถูกเรียกเก็บเงิน.
ไฟล์สำหรับเอเจนต์
| ไฟล์ | คืออะไร |
|---|---|
| openapi.json | OpenAPI 3.1. ทุก operation มีคำอธิบายและตัวอย่างคำขอที่ใช้ ticker จริง |
| llms.txt | คู่มือสั้น: hosts, company ids, value object, การอ่านแบบ ณ จุดเวลา (point-in-time), ขีดจำกัด |
| llms-full.txt | ทุกอย่างอยู่ในไฟล์ข้อความเดียว: ทุกเส้นทาง สูตรอัตราส่วน และวิธีใช้ |
| skill.md | Agent Skill พร้อมวิธีใช้แบบเรียกครั้งเดียว |
| skills.zip | Agent Skills (SKILL.md) ที่เรียกเครื่องมือ MCP รวมเป็นไฟล์ zip เดียว |
| pricing.json | ราคาต่อการเรียก ขีดจำกัดรายวัน และสถานะการชำระเงิน |
| mcp.json | การ์ดเซิร์ฟเวอร์ MCP: เครื่องมือ, การยืนยันตัวตน และเอกสาร |
| server.json | รายการ MCP Registry |
| agent.json | ดัชนีรวมของทุก endpoint และเอกสารด้านบน |
สิ่งที่ตัวแทนสามารถไว้วางใจได้
- ทุกตัวเลขมีแหล่งที่มา: accession number ของเอกสารที่ยื่นต่อ SEC, form, วันที่ยื่น, แท็ก XBRL และลิงก์ไปยังเอกสารบน sec.gov
GET /proof/{id}แสดงข้อเท็จจริงดิบที่อยู่เบื้องหลังตัวเลขนั้น. - ณ จุดเวลา:
known.fromและknown.toบอกว่าแต่ละค่าเป็นตัวเลขล่าสุดที่ยื่นในช่วงใดas_of,original=trueและhistory=trueใช้อ่านข้อมูลในอดีตโดยไม่มองล่วงหน้า และแสดงข้อมูลที่ปรับปรุงย้อนหลัง. - คำตอบสั้น ๆ: การเรียกงบการเงินจะคืนเฉพาะช่วงเวลาที่ขอ; ผลลัพธ์เครื่องมือ MCP จะขึ้นต้นด้วยสรุปหนึ่งบรรทัดก่อนข้อมูลที่มีโครงสร้าง.
- Ticker, CIK หรือชื่อ:
company=ticker:AAPL,company=cik:320193, หรือGET /v1/companies?q=Apple - ความครอบคลุม: ผู้ยื่นต่อ SEC ที่จดทะเบียนในตลาดหลักทรัพย์สหรัฐอยู่ในปัจจุบัน; งบการเงินมาตรฐานสำหรับผู้ยื่น US GAAP เป็นข้อมูลเท่านั้น ไม่ใช่คำแนะนำการลงทุน.