Repolode
akfamily

akfamily/aktools

AKShareの金融データインターフェースをHTTP APIとMCPサーバーで公開し、あらゆる言語やClaude、CursorなどのAIアシスタントから利用できます。

スター
1,557
フォーク
250
未解決の Issue
0
最終コミット
23 時間前

このページはオープンソースプロジェクトの紹介であり、投資助言ではありません。取引や投資には損失のリスクがあります。ご利用前にご自身でリスクを判断し、お住まいの地域の法令に従ってください。

これは何?

1,000種類以上の金融データインターフェースを提供するPythonライブラリAKShareをAKToolsがラップし、HTTP経由で利用できるようにします。AKShareの各関数には「/api/public/<interface name>」のようなパスからアクセスでき、クエリ文字列のパラメーターはそのまま渡され、結果はJSONで返されます。結果をCSVやExcelファイルとして出力することもできます。

同じサービスにMCPサーバーも含まれているため、Claude Desktop、Claude Code、CursorなどのAIアシスタントから、自然言語でのリクエストを使ってインターフェースを検索したり、パラメーターを確認したり、データを取得したりできます。インストールはpipコマンドを1つ実行してから「python -m aktools」を実行するだけです。MCPの設定では、別途サーバーを起動せずにuvxを利用できます。

デフォルトで結果を60秒間キャッシュする機能、サービスを保護するトークンオプション、GunicornおよびUvicornでのデプロイ用Dockerfile、FastAPIが提供するインタラクティブなAPIドキュメントを備えています。

主な機能

  • 01AKShareのすべてのデータインターフェースを、JSONを返すシンプルなHTTP GETエンドポイントとして公開します。
  • 02Claude、Cursorなど、MCPに対応したアシスタント向けのMCPサーバーを提供します。
  • 03_formatパラメーターを指定して、結果をCSVまたはExcel形式でダウンロードできます。
  • 04インターフェースの一覧表示や検索、パラメーターとデフォルト値の確認ができます。
  • 05同一のリクエストをデフォルトで60秒間キャッシュし、上流への負荷を軽減します。
  • 06オプションのアクセストークン、プロキシ設定、デプロイ用Dockerfileに対応しています。

ユースケース

  • A株の過去の価格データをPython、R、MATLABの分析スクリプトに取り込む。
  • AIアシスタントがリアルタイムデータを照会し、株式や債券に関する質問に回答できるようにする。
  • スクレイピングコードを書かずに金融データをExcelにエクスポートし、レポートに使う。
  • トークンとDockerを使って、チーム向けの共有データサービスを運用する。

クイックスタート

  1. 1

    PyPIからAKToolsをインストールする

    pip install aktools
  2. 2

    HTTPサービスを起動する

    python -m aktools
  3. 3

    ブラウザーでテストURLを開き、取引カレンダーのデータが読み込まれることを確認する

使う前に知っておきたいこと

  • データは公開されている上流サイトから取得するため、サイトの変更やアクセス制限により、一部のインターフェースが動作しない場合があります。
  • Python 3.11以降(64ビット)が必要です。

収録されている特集

トピック

よくある質問

aktools とは?
AKShareの金融データインターフェースをHTTP APIとMCPサーバーで公開し、あらゆる言語やClaude、CursorなどのAIアシスタントから利用できます。 1,000種類以上の金融データインターフェースを提供するPythonライブラリAKShareをAKToolsがラップし、HTTP経由で利用できるようにします。AKShareの各関数には「/api/public/<interface name>」のようなパスからアクセスでき、クエリ文字列のパラメーターはそのまま渡され、結果はJSONで返されます。結果をCSVやExcelファイルとして出力することもできます。
aktools は無料で使えますか?ライセンスは?
aktools は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
aktools は今もメンテナンスされていますか?
活発にメンテナンス中。aktools の最終コミットは 2026年11月6日 です。
aktools は何に使えますか?
A株の過去の価格データをPython、R、MATLABの分析スクリプトに取り込む。 AIアシスタントがリアルタイムデータを照会し、株式や債券に関する質問に回答できるようにする。 スクレイピングコードを書かずに金融データをExcelにエクスポートし、レポートに使う。 トークンとDockerを使って、チーム向けの共有データサービスを運用する。
aktools のインストール方法は?
PyPIからAKToolsをインストールする: pip install aktools HTTPサービスを起動する: python -m aktools ブラウザーでテストURLを開き、取引カレンダーのデータが読み込まれることを確認する
aktools はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/akfamily/aktools

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト