SocialForex

---

SocialForex は、個人のFX／ゴールド／暗号資産トレーダー向けのフルスタックなトレーディングコンパニオンです。ライブ市場データ、コミュニティのシグナルルーム、MT5のコピートレード、AIレビュー機能を備えた詳細なトレード日誌、初心者向けアカデミーを、ベトナム語と英語で提供します。

⚠️ このプロジェクトのすべての内容は、教育および情報提供のみを目的としています。投資アドバイスではありません。レバレッジ商品での取引には、資金を失う高いリスクが伴います。

機能

📈 市場データ

ライブ価格 — FX、貴金属、エネルギー、暗号資産に対応し、自動更新	ウォッチリストとAIによる専門家分析を備えたTradingViewチャート
マーケットスクリーナー — M15/H1/H4/D1の評価、通貨ペアごとのRSI、ADX	8つの主要通貨を対象とした通貨強弱ヒートマップ
経済カレンダー — VN/UTC時刻、影響度フィルター、AIによる解説	ライブデスク — すべての取引前に、チャート、ニュースリスク、ロットサイズを確認

📡 シグナルとコミュニティ

シグナルルーム — 無料およびVIPシグナル、MT5で検証済み、コメントと投票機能	信頼度の高いテクニカルシグナル — 4Hの強いシグナルをH1とM15で確認し、ソース（TradingView、CFTC COT、OANDA、Myfxbook、IG）ごとに精度を追跡
リーダーボード — 勝率、プロフィットファクター、XPを表示。フォローまたはコピーが可能	コミュニティのセンチメント — アクティブなシグナルから算出したロング／ショート比率
MT5コピートレード — 固定ロット／リスク率指定に対応したエキスパートアドバイザー	MT5ポジション — ライブ損益、週末／日末／損益分岐点での自動決済、AIポートフォリオレビュー

📒 トレード日誌と規律

トレード日誌 — MT5と自動同期し、勝率、ペイオフ、期待値を表示	高度な統計情報 — 規律スコアカード、ティルト日、ミスのタグ、MAE/MFE、週次・日次のAIレビュー
毎日のトレード計画 — 取引前チェックリスト、リスク上限、連勝・連敗	AI Auto-Scalp — 品質しきい値を設定した複数通貨ペアのスキャルピング分析
ウェブプッシュ通知に対応した価格アラート	ダッシュボード — 日々のアクティビティ、XPレベル、紹介プログラム

🎓 学習

アカデミー／Wiki — 初心者から上級者までのプライスアクション学習パス	AI による為替記事 — ウェブ検索とチャートのスナップショットで充実させた日次分析
初心者向けミッションボード — XP を獲得できる、自動検証付きの16個のタスク	計算ツール — ポジションサイズ、ピボットポイント、証拠金
バックテスト — モンテカルロ方式の資産曲線シミュレーション	ダークモードとモバイルファースト

スクリーンショットは node scripts/screenshots.mjs で再生成できます（口座残高は自動的にぼかされます）。

🤖 AI アシスタントから利用する（MCP）

SocialForex は、公開 MCP サーバーでもあります。MCP を通じて、Claude、Cursor、VS Code、DeepSeek Harness から、レート、経済カレンダー、スクリーナー、通貨の強弱、取引セッション、ポジションサイズ計算ツールを直接利用できます。

claude mcp add --transport http socialforex https://toolforex.xyz/api/mcp

ツール一覧とその他のクライアントについては、docs/mcp.md をご覧ください。

技術スタック

• Next.js 16（App Router）+ React 19、Tailwind CSS v4 + shadcn/ui
• Prisma 7 + PostgreSQL
• NextAuth v5（認証情報、JWT セッション）
• next-intl v4 — ベトナム語（デフォルト）と英語
• AI プロバイダー：DeepSeek、Groq、OpenAI、Anthropic（管理パネルで設定可能）
• コピー取引とポジション連携用の MetaTrader 5 エキスパートアドバイザー（docs/mt5）
• Vitest によるユニットテスト、Playwright によるエンドツーエンドテスト

はじめに

必要なもの：Node.js 20 以降、Docker（PostgreSQL 用）。

git clone https://github.com/namlxuit056/social-forex.git
cd social-forex
npm install
cp .env.example .env          # then fill in DATABASE_URL and AUTH_SECRET
npm run docker:up             # start PostgreSQL
npm run db:deploy             # apply migrations
npm run db:seed               # optional sample data
npm run dev                   # http://localhost:3000

必要なのは DATABASE_URL、AUTH_SECRET、NEXTAUTH_URL のみです。.env.example にあるその他すべてのキー（AI プロバイダー、Telegram、PayPal、OANDA、Myfxbook、Vercel Blob など）は、任意の機能を有効にします。

便利なコマンド：

npm run lint      # ESLint
npm test          # Vitest
npm run build     # production build

pm2 + Cloudflare Tunnel を使って自分のマシンでセルフホストする方法は、docs/self-hosting.md に記載されています。

貢献

Issue とプルリクエストを歓迎します。CONTRIBUTING.md をご覧ください。セキュリティ上の問題は、SECURITY.md に記載されている方法で非公開にてご報告ください。

プロジェクトを支援する

SocialForex は1人の開発者が開発・運営し、toolforex.xyz でホストされています。取引に役立っている場合は、ホスティング、データ、AI の費用をご支援いただけます。

• ☕ PayPal またはカードで支援する — 1回限り、1ドルから任意の金額
• ❤️ GitHub でスポンサーになる — 毎月
• ⭐ このリポジトリにスターを付け、toolforex.xyz を他のトレーダーと共有する
• 💬 Telegram グループに参加する：t.me/toolforex

ライセンス

GNU AGPL-3.0。このプロジェクトは利用、改変、セルフホストできます。改変版を公開サービスとして運用する場合は、同じライセンスのもとでソースコードを公開する必要があります。

---

Tiếng Việt

SocialForex は、FX・ゴールド・暗号資産のトレーダーを支援するオープンソースプラットフォームです。リアルタイム価格、コミュニティのシグナルルーム、MT5 のコピートレード、AI が規律を採点する取引日誌、経済カレンダー、スクリーナー、ヒートマップ、初心者向けアカデミーを提供します。

• 🌐 今すぐ試す：toolforex.xyz
• 🛠️ セルフホスト可能： Getting started をご覧ください
• ❤️ プロジェクトを支援する：toolforex.xyz/support の PayPal / カード または GitHub Sponsors — サーバー、データ、AI の費用を賄う助けになります
• 💬 Telegram グループ：t.me/toolforex
• 🤖 MCP 経由で AI アシスタント（Claude、Cursor、DeepSeek Harness…）から利用：https://toolforex.xyz/api/mcp — docs/mcp.md をご覧ください

すべての内容は教育目的のみであり、投資助言ではありません。