tres-ledger-link について
tres-ledger-linkは、TRES Financeの取引台帳にフィルターを適用したURLを作成するスキルです。共有や再利用向けに、組織のサブドメインをMCPで取得し、指定条件を設定してURLを検証します。
主な機能
- 01取引台帳のフィルター付きリンク生成
- 02MCP経由で組織サブドメインを取得
- 03日付、アカウント、資産のフィルター
- 04URLパラメーターのエンコードと検証
活用シーン
- 01期間を指定した取引ビューの共有
- 02ウォレット、資産、取引状態での絞り込み
- 03特定取引や保存済みフィルターへのリンク
MCP 対応
MCPでget_viewerを呼び出して組織名を取得します。不明なフィルターIDはexecuteツールで照会できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/tres-ledger-linkを入力して読み込まれたか確認します。
詳細
ダッシュボードの台帳リンクを生成する
ユーザーが顧客と共有できる（または自分で利用できる）、フィルターを正確に適用した状態で台帳のTransactions タブを開く、動作する TRES Finance ダッシュボード URL を生成します。
このスキルの対象はTransactions タブのみです。ユーザーが Accounting、Roll Forward、Pivot Tables、Cost Basis、Trial Balances へのリンクを求めた場合は、ここで作業を止め、このスキルはそれらのタブを対象としていないことを伝えてください。
Step 1 — 組織のサブドメインを解決する
ダッシュボード URL は https://<org-subdomain>.tres.finance/ledger です。
MCP の get_viewer クエリから <org-subdomain> を解決します（返された orgName を使用）。ユーザーに尋ねないでください。
query { viewer { orgName } }
最終メッセージには使用したサブドメインを記載してください。誤っていた場合、ユーザーが一度のやり取りで訂正できます。
Step 2 — ユーザーが希望するフィルターを収集する
ユーザーのリクエストから、日付範囲、ウォレット、資産、タグ、ステータスなどのフィルターを平易な言葉で読み取ります。フィルターが曖昧な場合（例：組織に複数の USDC バリエーションがあるのに「USDC」と指定された場合や、年を指定せずに「Q1」と指定された場合）は、生成する前に確認してください。誤った値を指定すると、何も表示されないビューや壊れたビューが気付かれずに生成されます。
ユーザーが明示的に指定したフィルターのみを含めてください。それ以外はダッシュボードがデフォルト値を適用します。余分なパラメーターはノイズになるだけです。
Step 3 — URL を組み立てる
ベースパスは常に次のとおりです。
https://<org-subdomain>.tres.finance/ledger
/ledger の後にパスセグメントを追加しないでください（Transactions タブが開きます）。
? を付け、その後に以下のルールに従って作成したクエリー文字列を追加します。すべての値を URL エンコードしてください（スペース → %20）。単一の値の中ではカンマをエンコードします。配列の各要素の区切りには、カンマをそのまま使用します。
3.1 日付とページネーション
| パラメーター | 形式／値 | 備考 |
|---|---|---|
fromDate | YYYY-MM-DD | UTC の日付 |
toDate | YYYY-MM-DD | UTC の日付 |
dateType | Month to date、Year to date、Last 30 days、Last month、Before this month、Custom date、All time、Year、Quarters | スペースを URL エンコードします。Last 30 days（デフォルト）の場合は省略します。任意の fromDate／toDate 範囲には Custom date を使用します。 |
page | 整数 | 1 の場合は省略します。 |
pageSize | 整数 | 20（デフォルト）の場合は省略します。 |
dateType=All%20time の場合、fromDate／toDate は無視されるため、含めないでください。
3.2 複数選択の配列フィルター（ID をカンマで連結）
| パラメーター | 指定する値 |
|---|---|
internalAccounts | 組織所有のウォレットの数値データベース ID |
tags | ウォレットグループ ID、またはラベルなしの場合は no-label |
thirdPartyAccounts | 外部アカウントの生のアドレス文字列（サブトランザクション上の送信者／受信者識別子。システム内の名前付き連絡先とは限りません） |
customNameLabelTags | 連絡先グループ ID |
addresses | 未識別アドレスの生の文字列 |
assetClasses | 資産クラスの列挙型 ID（例：CRYPTO、FIAT、NFT） |
assets | 資産 ID |
activities | 大文字のタグ ID（例：SPAM、STAKING）、または no-label |
automations | 自動化 ID |
platforms | 小文字のプラットフォーム名（例：ethereum、bitcoin。大文字の列挙値ではありません） |
actions | 金融アクションの列挙型名（例：SEND、RECEIVE） |
functions | デコードされた関数名 |
applications | アプリケーション ID |
protocols | プロトコル ID |
methodIds | 4 バイトの 16 進数メソッド ID（0xa9059cbb） |
transactionHash | トランザクションハッシュ |
transactionView | readyPending（デフォルト）、onlyReady、onlyPending、onlyDeleted |
transactionType | isManual、onlyPlug のいずれか |
filterByBookmark | 小文字のブックマーク種別 |
missingCounterMatchedTransfers | all（デフォルト）、false（対向振替あり）、true（対向振替なし） |
balanceFactor | 1（流入）、-1（流出）。通常は単一の値です。 |
amountAsset | 単一の資産 ID（amountBetween と組み合わせます） |
複数選択の値に必要な正確な ID が不明な場合は、まず execute MCP ツールを介して BFF にクエリーを送信し、調べてください。推測しないでください。
3.3 範囲フィルター
| パラメータ | 形式 | 備考 |
|---|---|---|
amountBetween | <min>,<max> | どちらかの側は空でもかまいません: 100,500 (範囲)、100, (100以上)、,500 (500以下)。カンマ1つは必須です。 |
3.4 ブールフィルター (true の場合にのみ含める)
showSpam、missingFiat、failedTransactions、nonTaxableType、missingCostBasis、
internalTransactions、ignoreFee
例: ?showSpam=true&missingFiat=true。=false は決して出力しないでください — false がデフォルトです。
3.5 ノート / ラジオと入力の組み合わせ
| パラメータ | 値 |
|---|---|
commentContains | 1 = ノートあり、-1 = ノートなし、0 = すべて表示 (省略)、またはノート内容を検索する任意のテキスト文字列 |
3.6 その他の単一値
| パラメータ | 形式 |
|---|---|
savedFilters | 保存済みフィルター ID (単一値) |
description | 単一の文字列 |
globalSearch | 単一の文字列 |
Step 4 — 送信前に検証する
URL をこのチェックリストに沿って確認してください。いずれかのルールに違反している場合は、引き渡す前に修正してください。
- パスが正確に
/ledgerであること。タブのサフィックスや?id=...は付けません。 fromDate/toDateはdateType=Custom%20date(またはdateTypeを省略) と組み合わせること。Last%2030%20daysやAll%20timeと組み合わせてはいけません。- どのブール値にも
=falseを付けないこと。 - 複数選択の値はカンマで結合し、キーを繰り返さないこと (
?platforms=ethereum,bsc、?platforms=ethereum&platforms=bscにはしない)。 platformsの値は小文字化すること (ETHEREUMではなくethereum)。その他の enum ID は スキーマに一致させること (SpamではなくSPAM、cryptoではなくCRYPTO)。amountBetweenは片側が開いていても、必ずカンマをちょうど1つ含むこと。activitiesにSPAMが含まれる場合は、リンクが自己完結するようにshowSpam=trueも設定すること。transactionHashが設定されている場合、ダッシュボードは日付フィルターを無視します — ユーザーの リクエストに日付もある場合は警告してください。- スペースは URL エンコードすること (
Custom date→Custom%20date)。 - ユーザーが要求したフィルターのみを含めること。
Step 5 — 引き渡す
コピーしやすいように、URL を単独の行に記載して送信してください。どのフィルターがエンコードされているか (およびどのサブドメインを使用したか) を簡潔に伝え、ユーザーが顧客に転送する前に確認できるようにしてください。
引き渡しの例:
組織
<subdomain>向けに構築: フィルターは platform=ethereum、activities=SPAM、fromDate/toDate 2026年4月 (Custom date)、showSpam=true です。https://.tres.finance/ledger?fromDate=2026-04-01&toDate=2026-04-30&dateType=Custom%20date&platforms=ethereum&activities=SPAM&showSpam=true
実例
先月の Ethereum SPAM トランザクション:
https://<subdomain>.tres.finance/ledger?fromDate=2026-04-01&toDate=2026-04-30&dateType=Custom%20date&platforms=ethereum&activities=SPAM&showSpam=true
2つの特定ウォレットの全期間ビュー:
https://<subdomain>.tres.finance/ledger?dateType=All%20time&internalAccounts=12345,67890
USD のみの 50k 以上の大口送金:
https://<subdomain>.tres.finance/ledger?assetClasses=FIAT&amountBetween=50000,&amountAsset=USD
2026年第1四半期のフィアット欠落した失敗トランザクション:
https://<subdomain>.tres.finance/ledger?fromDate=2026-01-01&toDate=2026-03-31&dateType=Custom%20date&failedTransactions=true&missingFiat=true
特定の保存済みフィルター:
https://<subdomain>.tres.finance/ledger?savedFilters=12345
ルール
- このスキルは、ユーザーが平易な英語で説明する一般的なアドホック絞り込みビュー向けです。 作成直後の
単一トランザクションを固定して、保留中/遡及の行を即座に表示するには、
dateType=All%20timeとともにtransactionHashを設定してください。 - このスキルの外で台帳 URL を手作業で作らないでください — ユーザーが台帳 / ダッシュボード / フィルター リンクを求めたときは常にこれを使用してください。
- ブールフィルターに
=falseを決して含めないでください。 - キーを繰り返さないでください (
?x=a&x=b) — カンマで結合して1つの値にしてください。 - ダッシュボードが enum ID を期待する箇所で表示名を決して使用しないでください。
- 応答する前に必ず Step 4 のチェックリストに照らして検証してください。
- 引き渡しメッセージには必ず使用したサブドメインとフィルターを記載してください。