EDGAR® dhe SEC® janë marka tregtare të US Securities and Exchange Commission. ky blog post dhe projekti i lidhur me burim të hapur nuk janë të lidhura me, miratuar nga, ose në asnjë mënyrë të lidhur me US Securities and Exchange Commission. EDGAR® dhe SEC® janë marka tregtare të US Securities and Exchange Commission. ky blog post dhe projekti i lidhur me burim të hapur nuk janë të lidhura me, miratuar nga, ose në asnjë mënyrë të lidhur me US Securities and Exchange Commission. Përmbledhje Në vitin 1934, Kongresi i SHBA-ve krijoi Komisionin e Çmimeve dhe Bursave (SEC) për të mbikëqyrur tregjet financiare dhe për të mbrojtur investitorët. Agjencia është ndërtuar mbi një parim të thjeshtë: investitorët meritojnë informacione të sakta, të vërteta dhe të plota për kompanitë në të cilat duan të investojnë. “Ata që kërkojnë të përfitojnë nga paratë e të tjerëve duhet të jenë plotësisht të sinqertë në lidhje me faktet mbi të cilat kërkohet gjykimi i investitorit.” Franklin Delano Roosevelt, Presidenti i 32-të i Shteteve të Bashkuara “Ata që kërkojnë të përfitojnë nga paratë e të tjerëve duhet të jenë plotësisht të sinqertë në lidhje me faktet mbi të cilat kërkohet gjykimi i investitorit.” Franklin Delano Roosevelt, Presidenti i 32-të i Shteteve të Bashkuara Për gati një shekull, SEC ka shërbyer si mbikëqyrës i transparencës në botën financiare, duke kërkuar që kompanitë publike të zbulojnë gjithçka nga fitimet tremujore në kompensimin e drejtuesve, nga rreziqet e biznesit në ngjarjet e mëdha të korporatave. nëpërmjet saj Sistemi (lansuar në vitet 1990) SEC ka bërë këto dosje në dispozicion të lirë për këdo me një lidhje interneti. Të dhënat elektronike të mbledhjes, analizës dhe marrjes ( EDGAR Në teori, kjo krijoi një fushë të barabartë ku investitorët individualë mund të kenë qasje në të njëjtat të dhëna si investitorët profesionistë. Investitorët institucionalë kanë analistë, softuerë të sofistikuar dhe miliona në infrastrukturën teknologjike për të analizuar, analizuar dhe nxjerrë njohuri nga dosjet e SEC. Ata duhet të lundrojnë manualisht nëpër dokumente të dendura dhe komplekse që shpesh mbulojnë qindra faqe. Retail investors don’t For example, a single Apple annual report ( 10-K filing) contains over 100 pages of financial data, business descriptions, and risk factors. Investitorët profesionistë sistematikisht nxjerrin metrikë specifike, krahasojnë tendencat përgjatë tremujoreve dhe viteve, analizojnë performancën e segmentit dhe identifikojnë modelet që do të ishin pothuajse të pamundura për të zbuluar përmes rishikimit manual. The problem goes beyond just having access to data. But today things have changed, individual investors can now keep up. Modelet e mëdha të gjuhës, Protokolli i Kontekstit të Modelit dhe qasja programatike në të dhënat e SEC EDGAR po e bëjnë më në fund kërkimin financiar të sofistikuar të arritshëm për investitorët individualë.Tani mund të përdorni AI për të nxjerrë metrikat kryesore financiare, të kryeni analiza komplekse në shumë kompani dhe periudha kohore dhe të zbuloni njohuri që më parë kërkonin ekspertizë të specializuar dhe mjete të shtrenjta. Si saktësisht funksionon kjo në praktikë?Le të zhytemi në themelin teknik që e bën këtë të mundur: (Liruar në versionin 21 korrik 2025), një softuer me burim të hapur i ndërtuar publikisht dhe i mirëmbajtur nga komuniteti që transformon mënyrën se si investitorët ndërveprojnë me hulumtimet financiare. Shërbimi SEC EDGAR MCP 1-alpha Si ndryshon gjithçka Para se të zhytemi në detajet teknike, le të kuptojmë se çfarë e bën këtë qasje thelbësisht të ndryshme nga mjetet tradicionale të hulumtimit financiar dhe rrjedhat e punës. Protokolli i Kontekstit të Modelit (MCP) është një standard i hapur që lejon asistentët e AI të lidhen në mënyrë të sigurtë me burimet dhe mjetet e të dhënave të jashtme. mendoni për të si një lidhje universale që lejon asistentin tuaj të AI të hyjë dhe të flasë drejtpërdrejt me bazat e të dhënave, API-të dhe shërbimet, duke përfshirë sistemin EDGAR të SEC-së. Hulumtimet tradicionale financiare shpesh përfshijnë kalimin në mes të platformave të shumta: kërkimi i kompanive në një vend, shkarkimi i skedarëve nga një tjetër, pastaj kopjimi manual i të dhënave në fletëvotime për analizë. With an MCP server, your AI assistant can do all of this seamlessly in a single conversation. Nga të dhënat e para në inteligjencë Le të shohim një shembull praktik. supozoni se ju doni të analizoni të dhënat financiare të Microsoft. tradicionalisht, kjo do të përfshijë: Gjetja e dosjeve të fundit të MSFT 10-Q (raportin tremujor) ose 10-K (raportin vjetor) në EDGAR Shkarkimi dhe hapja e dokumenteve të shumta PDF Kërkimi manual për të dhënat e të ardhurave të segmenteve Kopjimi i numrave në një tabelë Llogaritja e normave dhe tendencave të rritjes Me SEC EDGAR MCP, i gjithë ky proces bëhet një bisedë e thjeshtë: Asistenti i AI-së merret me të gjitha kompleksitetet teknike prapa skenave dhe ju paraqet me rezultate të pastra, të formatuara: "Më tregoni bilancin e Microsoft, raportin e të ardhurave dhe të dhënat e fluksit të parave." https://youtu.be/HEWTR15-xZc?embedable=true Një shembull tjetër do të ishte për të analizuar të ardhurat e fundit të Apple: https://youtu.be/T-6H3zF8fWU?embedable=true Ose krijoni një bord me grafika, në fluturim, bazuar në të dhënat më të fundit financiare të NVIDIA: https://youtu.be/UH2JPfhuoGU?embedable=true Ne gjithashtu mund të kërkojmë për transaksionet e fundit të brendshme në Amazon: https://youtu.be/k4sVFcHpmfg?embedable=true Ose hetoni hyrjet e të dhënave specifike të kompanisë nga dosjet e Apple, dhe komplotoni ato: https://youtu.be/V2rSkgYZXGg?embedable=true Për të përdorur këtë rrjedhë pune, do t'ju duhet një LLM që funksionon që mbështet protokollin MCP, të tilla si: (i përdorur në demonstratat). serveri punon në mënyrë lokale nëpërmjet Docker. Xhensila Desktop Ju mund të ndiqni udhëzimet se si të instaloni dhe përdorni atë . Këtu Por prisni, SEC siguron API për të hyrë në të dhënat EDGAR. Përse të mos bëjmë zjarr? Përgjigja qëndron në kompleksitetin dhe përdorshmërinë. APIs REST të SEC janë të fuqishme, por kërkojnë ekspertizë teknike për t'u përdorur në mënyrë efektive. Ju duhet të kuptoni identifikuesit e kompanisë (CIKs), taksonomitë e dosjes, strukturat XBRL, dhe si të lundroni përgjigjet komplekse JSON. Gjithashtu, ju duhet të dini se si të kodoni. Për një pyetje të thjeshtë si Ju do të duhet të shkruani një software për të gjetur Apple (Central Identifier Key), gjeni dosjen e duhur, parse të dhënat, dhe të nxjerrë konceptin specifik financiar. e gjithë kjo para se ju edhe të merrni në analizë. Cilat ishin të ardhurat e Apple në tremujorin e kaluar? CIK XBRL Kjo kompleksitet natyrisht çon në një pyetje tjetër: pse jo vetëm të pyesni ChatGPT ose asistentët e tjerë të AI direkt për të dhënat financiare, pa një server MCP? Pse jo të përgjithshme LLMs? Sfida këtu është saktësia dhe monedha. modelet e inteligjencës artificiale me qëllim të përgjithshëm janë të trajnuar në të dhënat me datat e prerjes, që do të thotë se ata nuk kanë informacion të fundit financiar. Ndërsa ata mund të lundrojnë në internet dhe të përpiqen të gjejnë të dhënat financiare, ata mund të humbasin detaje të rëndësishme. Kur ju jeni duke bërë vendime investimi, ju keni nevojë për të dhëna aktuale, të verifikuara dhe të plota nga burimi. Kjo është pikërisht problemi që serveri SEC EDGAR MCP është projektuar për të zgjidhur. Siç mund ta shihni nga kjo , LLM i lidhur me serverin MCP është në gjendje të konsumojë informacionin bazuar në dosjen origjinale, burimi më i mirë i informacionit në dispozicion: Bisedë Të gjitha të dhënat burojnë direkt nga dosja SEC EDGAR e NVIDIA (Formulari 10-Q, i dorëzuar më 28 maj 2025, Numri i Anëtarësimit: 0001045810-25-000116) me saktësi të ruajtur nga të dhënat origjinale XBRL. Të gjitha të dhënat burojnë direkt nga dosja SEC EDGAR e NVIDIA (Formulari 10-Q, i dorëzuar më 28 maj 2025, Numri i Anëtarësimit: 0001045810-25-000116) me saktësi të ruajtur nga të dhënat origjinale XBRL. Funksionimi i brendshëm i serverit MCP Ky paketë me burim të hapur është i disponueshëm lirisht për këdo për të përdorur, modifikuar dhe përmirësuar. paketa ofron mbi 20 mjete të specializuara për LLMs, të cilat trajtojnë gjithçka nga gjetja e dosjeve të kompanisë deri në nxjerrjen e metrikave komplekse financiare: Ju mund të lexoni më shumë në detaje për çdo mjet në . Dokumentacioni Ja çfarë e bën atë të fuqishme: Në vend që të analizojë manualisht qindra faqe të dokumenteve financiare, paketa mund të nxjerrë automatikisht tregues të caktuar si të ardhurat sipas segmenteve gjeografike, krahasimet tremujore ose të dhënat e kompensimit të drejtuesve. Smart data extraction and parsing Paketa prek në disa rrjedha të të dhënave SEC, nga baza kryesore EDGAR në RSS-feeds në kohë reale të dosjeve të reja, kështu që ju keni qasje në të dy të dhënat historike dhe përditësimet më të fundit të kompanisë. Multiple data sources Dosjet moderne të SEC-së përdorin XBRL (Extensible Business Reporting Language), një format të strukturuar që e bën të dhënat financiare të lexueshme me makinë. XBRL analysis Kompanitë e ndryshme raportojnë të dhënat në mënyra të ndryshme. Apple mund të ndajë të ardhurat sipas "Amerikës, Evropës dhe Kinës së Madhe" ndërsa Microsoft përdor kategori të ndryshme rajonale. Company-specific insights Burimi i hapur, pse ka rëndësi? The decision to make this package open source isn't just about free access, it's about transparency and community-driven innovation. Kur jeni duke marrë vendime investimi, ju duhet të besoni jo vetëm të dhënat, por metodat e përdorura për të nxjerrë dhe analizuar atë. Burimi i hapur do të thotë që ju mund të kontrolloni saktësisht se si punon paketa, të kontribuoni përmirësime dhe ta përshtatni atë për nevojat tuaja specifike. Duke shikuar përpara SEC ka mbledhur zbulime të korporatave për gati 90 vjet. të dhënat janë të gjitha atje, në dispozicion të lirë për këdo. por deri më tani, nxjerrja e kuptimeve të kuptueshme nga këto të dhëna kërkoi kohë, ekspertizë të thellë teknike dhe mjete të shtrenjta analitike. Me MCP dhe LLMs, investitorët individualë mund të bëjnë pyetje në anglisht të thjeshtë dhe të marrin përgjigje të sakta të mbështetura nga dosjet zyrtare të SEC. Nuk është një teknologji revolucionare, është thjesht inxhinieri e mirë e aplikuar në një problem të vërtetë.SEC EDGAR tashmë ofron API, kompanitë tashmë dosje në formate të strukturuara, asistentët e AI tashmë ekzistojnë. The MCP just connects these pieces together in a way that's actually useful for investors. Roosevelt donte tregje ku investitorët individualë mund të marrin vendime të informuara. Ajo që kërkoi ekipet e analistëve më parë tani mund të bëhet në një bisedë nga kushdo. Now open-source tools are providing the accessibility Maybe the information advantage that Wall Street has held for decades is disappearing. Njoftime Kjo punë nuk do të ishte e mundur pa themelin e vënë nga shumë të tjerë. meriton njohje për punën e pabesueshme të ruajtjes së një prej sistemeve më gjithëpërfshirëse dhe të arritshme të zbulimit të korporatave në botë.Baza e të dhënave EDGAR dhe API-t REST ofrojnë bazën e besueshme të të dhënave që e bëjnë të mundur një mjet të tillë. The US SEC krijoi standardin Model Context Protocol dhe vazhdon të përparojë në fushën e sigurisë dhe aftësive të AI. Angazhimi i tyre ndaj standardeve të hapura mundëson llojin e ndërveprueshmërisë që përfiton të gjithë. Anthropic E majta Paketë SEC EDGAR MCP GitHub Repository: https://github.com/stefanoamorelli/sec-edgar-mcp Dokumentacioni: https://sec-edgar-mcp.amorelli.tech Burimet e SEC Baza e të dhënave EDGAR: https://www.sec.gov/edgar SEC REST API: https://www.sec.gov/edgar/sec-api-documentation Kërko kompani EDGAR: https://www.sec.gov/edgar/searchedgar/companysearch SEC Investor.gov: https://www.investor.gov/ në internet Shërbimi.gov Protokolli i Kontekstit të Modelit (MCP) Specifikimi i MCP: https://modelcontextprotocol.io/ Anthropic MCP Dokumentimi: https://docs.anthropic.com/en/docs/build-with-claude/computer-use Serverë MCP Repository: https://github.com/modelcontextprotocol/servers Paketa me burim të hapur edgartools (nga Dwight Gunning): https://github.com/dgunning/edgartools datamule (nga John Friedman): https://github.com/john-friedman/datamule-python Të dhënat financiare dhe analiza XBRL Ndërkombëtare: https://www.xbrl.org/ SEC XBRL Informacion: https://www.sec.gov/structureddata/osd-inline-xbrl.html OpenFIGI (Identifikuesi Global i Instrumentit Financiar): https://www.openfigi.com/ Ligji për Transparencën e të Dhënave Financiare: https://www.congress.gov/bill/117th-congress/house-bill/2989 Kontekst historik Ligji i Çmimeve të 1933: https://www.investor.gov/introduction-investing/investing-basics/role-sec/laws-govern-securities-industry#secact1933 Ligji i Bursës së Çmimeve të 1934: https://www.investor.gov/introduction-investing/investing-basics/role-sec/laws-govern-securities-industry#secexact1934 Franklin D. Roosevelt Presidential Library: https://www.fdrlibrary.org/
