ข้ามไปยังเนื้อหา

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.jsonOpenAPI 3.1. ทุก operation มีคำอธิบายและตัวอย่างคำขอที่ใช้ ticker จริง
llms.txtคู่มือสั้น: hosts, company ids, value object, การอ่านแบบ ณ จุดเวลา (point-in-time), ขีดจำกัด
llms-full.txtทุกอย่างอยู่ในไฟล์ข้อความเดียว: ทุกเส้นทาง สูตรอัตราส่วน และวิธีใช้
skill.mdAgent Skill พร้อมวิธีใช้แบบเรียกครั้งเดียว
skills.zipAgent 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 เป็นข้อมูลเท่านั้น ไม่ใช่คำแนะนำการลงทุน.