NEARpedia

AI エージェント向けの最新NEARナレッジ。NEARpediaはMCPサーバーとREST APIを提供します。コーディングエージェントがNEARのコードを書こうとしたとき、それがすでに古くなっているかを知らせ、すべての回答に情報源と日付を添えて代替案を提示します。同じインデックスはNEARについて調べる人にも利用され、プロトコルのアップグレード、House of Stakeの投票、バリデーター、プロジェクト、インシデントを扱うサイトと/askチャットを提供します。

NEAR Hackathon（2026年11月1～14日、トラックはopenとagents）向けに開発されました。2026年11月2日からnear-pedia.xyzで公開中です。MCPエンドポイントhttps://near-pedia.xyz/mcpにキーは不要です。

デモ動画（81秒）：youtu.be/L1mbTEWWraE。

ヒント

エージェントは記憶している情報をもとにNEARコードを書きますが、NEARは進化し続けています。過去1年間の変更のうち、最初の2つはこのハッカソンの数週間前に起きたもので、以前に学習したモデルは知ることができません。

• near-sdk-jsはアーカイブされ、READMEには「使用しないでください」と記載されています。
• nearcore 2.14.0ではDelegateV2が削除されています。
• NEAR Lakeは終了し、docs.near.orgからチュートリアルがなくなりました。
• @near-js/*パッケージは2.5.1で更新が止まっています。現在も保守されているパッケージはnear-api-js 7.xで、keyStoresは含まれていません。

パッケージレジストリがこうした変更を通知することはほとんどないため、エージェントがそれに気づくのはビルドやトランザクションが失敗したときです。公式のnear/agent-skillsは静的な指示であり、nearai/near-mcpは最新情報への回答ではなく、チェーン上のアクションを実行します。

仕組み

廃止検出エンジンは、アーカイブされたリポジトリ、READMEにある「廃止済み／使用しないでください」という記述、npmとcrates.ioの廃止またはyankフラグ、リリースノートでの削除、ドキュメント独自の廃止マーカーや削除済みページ、後継が存在する長期間更新されていないパッケージという、6つのシグナルを使います。シグナルが弱い場合は「廃止の可能性あり」と報告します。レーダーには現在有効な情報だけが表示されます。対象が解決されると、すべてのアラートは終了します。

3つの利用方法

エージェントを接続する

claude mcp add --transport http nearpedia https://near-pedia.xyz/mcp

またはClaude Codeでは、プラグインを利用できます。同じサーバーに、NEARのコードを作成する前後にチェックするスキルが付属します。

/plugin install nearpedia --marketplace UnityNodes/near-pedia

次にClaude Codeに、JavaScriptでメタトランザクションを使うNEARコントラクトを作成し、nearpediaツールでチェックするよう依頼します。check_codeは、near-sdk-jsとDelegateV2を特定し、それぞれの置き換え先を示します。

[mcp_servers.nearpedia]
url = "https://near-pedia.xyz/mcp"

{
  "mcpServers": {
    "nearpedia": { "url": "https://near-pedia.xyz/mcp" }
  }
}

GitHub Action は、プルリクエストで変更されたファイルに対して check_code を実行し、コメントを 1 つ残します。NEAR で非推奨、削除、または変更された機能を使っている各行と、その代替機能および参照元を示します。.github/workflows/nearpedia.yml を追加してください。

name: NEARpedia
on: pull_request
permissions:
  contents: read
  pull-requests: write
jobs:
  check:
    runs-on: ubuntu-latest
    steps:
      - uses: UnityNodes/near-pedia/github-action@main

キーは不要です。2026 年 11 月 3 日に確認したところ、near-examples/coin-flip-examples#37 にはそのような行が 7 行ありました。near-api-js 7 で置き換えられた @near-js/* パッケージと、メジャーバージョンが 1 つ以上古い依存関係です。Action が書き込むコメントを確認するには、このリポジトリに古い NEAR コードを追加するデモ用プルリクエスト UnityNodes/near-pedia#5 を開いてください。1 つのコメントに 12 件の検出結果がまとまり、変更された行にも注釈が付きます。入力、出力、および何もインストールせずに任意の公開プルリクエストに対して実行する方法は、github-action/README.md に記載されています。

どの程度一般的かというと、2026 年 11 月 3 日時点で、公開リポジトリのある NEAR ハッカソンプロジェクト 67 件のうち 19 件が、NEAR で非推奨、削除、または変更された機能を使っていました。最も多かったのは keyStores と @near-js/* パッケージです。手法と、対象を名指しせずに任意のクローン群で同じチェックを実行するスクリプトは、docs/demo/hackathon-stale-count.md に記載されています。他のチームを特定しないよう、67 件のリポジトリは列挙していません。この数値は任意の対象群で再計算できますが、同じ対象群について再確認したものではありません。

稼働中の API で試す

インストール不要、キー不要です。

# a file written from memory: three findings, each with its replacement and sources
curl -s -X POST https://near-pedia.xyz/api/v1/check-code -H 'Content-Type: application/json' \
  -d '{"filename":"contract.ts","code":"import { NearBindgen } from \"near-sdk-js\";\nconst d = { DelegateV2: signed };\nconst ks = new keyStores.InMemoryKeyStore();"}'

# the mainnet protocol version, the upgrade vote by stake and the voting schedule
curl -s 'https://near-pedia.xyz/api/v1/protocol?network=mainnet' | head -c 600

# what is changing now, each alert with what ends it
curl -s https://near-pedia.xyz/api/v1/radar | head -c 600

check_code は次のように回答します。1 行目は near-sdk-js をインポートしていますが、これはアーカイブ済みなので、Rust の near-sdk を使用してください。2 行目は DelegateV2 アクションを構築していますが、これは nearcore 2.14.0 で削除されたため、通常のアクセスキーで署名した Delegate を使用してください。3 行目は keyStores を使用していますが、これは near-api-js 7 に含まれていないため、KeyPairSigner を使用してください。

自分で実行する

クリーンなクローンから判定する場合：

git clone https://github.com/UnityNodes/near-pedia
cd near-pedia
npm ci
npm run db:init
npm run sync:near          # every source is read live, about 25 minutes
npx tsx mcp-server.ts      # MCP and REST on :3131, leave it running

別のターミナルで：

curl -s -X POST http://127.0.0.1:3131/api/v1/check-code -H 'Content-Type: application/json' \
  -d '{"filename":"contract.ts","code":"import { near } from \"near-sdk-js\";\nconst a = { DelegateV2: signed };"}'
curl -s 'http://127.0.0.1:3131/api/v1/protocol?network=mainnet' | head -c 600
curl -s -X POST http://127.0.0.1:3131/api/v1/explain-error -H 'Content-Type: application/json' \
  -d '{"error_text":"wasm execution failed with error: MethodResolveError(MethodNotFound)"}'
curl -s http://127.0.0.1:3131/api/v1/contracts/intents.near | head -c 600
claude mcp add --transport http nearpedia http://127.0.0.1:3131/mcp

25 分かかる同期を行う時間がない場合は、http://127.0.0.1:3131 の代わりに https://near-pedia.xyz に対して同じ curl を実行すると、稼働中のインデックスから応答が返ります。また、npm test に同期は不要です。同期を行わない場合、ローカルサーバーは explain-error と contracts（キュレーションデータとライブ RPC）には応答しますが、非推奨機能のインデックスは空で、プロトコルスナップショットもまだありません。

check_code の検出結果が 2 件（1 行目の near-sdk-js、2 行目の DelegateV2。それぞれ参照元が付き、参照元に日付がある場合は日付も表示されます）、投票日と投票済みステークの割合を含むメインネットのアップグレード情報、MethodNotFound エラーの意味と修正方法、RPC からライブで読み取った intents.near にデプロイ済みのメソッドが確認できます。npm run build && npm run start は、同じデータベースから :3130 でサイトを配信します。npm test は、ネットワークやキーなしで 938 件のテストを実行します。各部分で何を確認するかは、docs/TESTING.md に記載されています。

必要なもの

• Node 22（better-sqlite3 はその ABI 向けにビルドされます。.nvmrc を参照してください）
• 上記の手順にキーは不要です。NEARAI_API_KEY を設定すると、semantic_search 用のコーパスが埋め込まれます（設定しない場合は単語を照合します。埋め込みには約 50 分かかります）。また、/ask が有効になります。GITHUB_TOKEN を設定すると、NEAR リポジトリの未解決の Issue とディスカッションが追加されます。

実装済みの内容

app/            Next.js pages and route handlers
components/     UI components
lib/            database client, search, ranking, embeddings, parsers, shared helpers
scripts/        sync-*.ts (one per source), check-*.ts, backfills, anchor-db.ts
mcp-server.ts   MCP server and REST API v1
contracts/      db-anchor, the Rust contract that records the daily database hash
plugin/         Claude Code plugin: the MCP server and the near-current skill
github-action/  the pull-request check (action.yml, no dependencies)
deploy/         systemd units, Caddyfile, sync-tick.sh, git hooks
docs/           setup (cron) and distribution notes
assets/         the images in this README
tests/          Vitest

ハッカソン前に構築したものと、期間中に構築したもの

ハッカソンのルールでは、2026年10月19日以降の作業が対象です。それ以前のものはすべてベースラインです（ハッカソンFAQの項目Q-001、Q-002、Q-005）。私たちはさらに厳格に、テンプレート自体を境界としています。

ベースラインであり、ハッカソンの作業ではないもの。 エンジンは、以前に構築したエコシステムに依存しないナレッジハブ、CCPEDIA（Canton）とBlobpedia（Celestia）から抽出した pedia-template のコピーです。データベース層、検索と埋め込み、MCPサーバーとRESTサーバー、ウェブUI、同期ランナー、定期チェックを備えています。リポジトリの最初のコミットはこのコピーで、pre-hackathon タグを付けて2026年11月1日にコミットしました。また、10月20～21日にテンプレートで行った、NEAR固有ではない一般的なエンジンの保守作業も含まれています。これについても成果として主張せず、ベースラインとして扱います。

ハッカソンでの作業。 そのタグ以降のすべてです。NEARへのリブランド、NEARのソース、非推奨化エンジン、check_code、RPC、バリデーターとHouse of Stakeのリーダー、エコシステム、インシデントとパートナーのデータ、レーダー、27個のツールを備えたMCP機能、GitHub Action、Agent Market移行エージェント、サイトのページ、NEAR AI Cloudとの統合、データベースのハッシュコントラクト、配布ファイルが含まれます。変更の全容は次のリンクで確認できます（FAQ Q-003）：pre-hackathon...main。

他のプロジェクトからのコード。 lib/retry.ts と lib/polite-fetch.ts は、私たちのMonadナレッジハブであるMonpedia（2026年10月）から移植しました。移植時に条件付きリクエストを追加しています。

サードパーティーのコード。 package.json に記載されたオープンソースライブラリ（Next.js、React、better-sqlite3、sqlite-vec、MCP SDK、Express、zod、@nearai/inference-sdk、near-api-js など）と contracts/db-anchor/Cargo.toml の near-sdk は、それぞれ独自のライセンスに従います。2つのLottieアニメーションは public/animations/CREDITS.txt にクレジットを記載しています。サイトと assets/ 内の画像では、SIL Open Font License 1.1に基づくSpace GroteskとJetBrains Monoを使用しています。

AIによる支援。 ベースラインを含む、このリポジトリのコードはClaude Codeを使って作成しました。

もう一つのハッカソンプロジェクト

チームは、残高から自分の思考の費用を支払うAIペットNFT Hungry Minds も応募しています（nfts と games を追跡）。2つのプロジェクトは独立しており、コードを共有していません（Q-015）。

公式プロジェクトではありません

NEARpediaは独立したコミュニティプロジェクトです。NEAR Foundation、NEAR AI、House of Stakeの製品ではありません。それぞれの公開ソースを読み込み、各ソースへのリンクを掲載しています。

License

MIT.

Maintained by Unity Nodes.