Get started

Get started with SAPJP

公開記事を検索し、MCPサーバーや外部AIアプリに渡しやすいJSONとして返します。 SAPとABAPの記事資産を、安全に参照できる知識APIです。

Get Started Try API 
curl "https://sapjp.net/wp-json/sapjp/v1/context?query=ABAP"

Knowledge APIs

Build with article context

Search

Search API

ABAP、SAP、S/4HANAなどのキーワードで関連記事を取得します。

Method
GET
Limit
20 results
Read docs

Retrieve

Article API

記事IDからタイトル、URL、本文、カテゴリ、タグを取得します。

Method
GET
Returns
Full text
Read docs

Context

AI Context

AIに渡しやすい短いコンテキストとして複数記事をまとめます。

Method
GET
Use
MCP / RAG
Read docs

Endpoints

API一覧

Method Path Purpose
GET /wp-json/sapjp/v1/search 公開記事をキーワード検索する
GET /wp-json/sapjp/v1/articles/{id} 1記事の本文とメタデータを取得する
GET /wp-json/sapjp/v1/articles/{id}?format=structured 記事を見出し単位のセクションとして取得する
GET /wp-json/sapjp/v1/articles/{id}/code 記事内のABAPコード例を抽出する
GET /wp-json/sapjp/v1/context AI向けに短く整形された文脈を取得する
GET /wp-json/sapjp/v1/topics/{topic} カテゴリまたはタグの関連記事を取得する

Search

記事を検索する

query に検索語を指定すると、関連する公開記事を返します。 category でカテゴリスラッグを指定し、limit で最大件数を制限できます。

  • query / q: 検索キーワード
  • category: カテゴリスラッグ。任意
  • limit: 最大20件。任意
Request
curl "https://sapjp.net/wp-json/sapjp/v1/search?query=ABAP&limit=5"

Article

1記事を取得する

記事IDを指定して、AIが参照できるプレーンテキスト本文を取得します。 下書き、非公開、パスワード保護記事は返しません。

Request
curl "https://sapjp.net/wp-json/sapjp/v1/articles/123"

Structured

見出し単位で取得する

format=structured を指定すると、記事本文に加えて sections を返します。 AIに「どの見出しの内容か」を渡したい場合に使います。

Request
curl "https://sapjp.net/wp-json/sapjp/v1/articles/123?format=structured"

Code

ABAPコード例を抽出する

記事中のコードブロックだけを抽出します。 ABAPレビューAIやコード例検索の材料として使いやすい形式です。

Response
{
  "article_id": 123,
  "title": "ABAP SELECTの基本",
  "count": 1,
  "snippets": [
    {
      "language": "abap",
      "code": "SELECT * FROM vbak."
    }
  ]
}

Context

AI向けの文脈を取得する

MCPサーバーやAIアプリから使う場合は、まずこのエンドポイントを使うのが扱いやすいです。 検索結果を短く整形し、`sources` 配列として返します。

  • 空の query はエラーになります。
  • 本文はAIに渡しやすい長さに切り詰められます。
  • 回答時の出典表示に使えるURLを含みます。
Response
{
  "query": "ABAP SELECT",
  "count": 1,
  "context": "## ABAP SELECTの基本\nURL: https://sapjp.net/example/\nSELECT文の基本...",
  "sources": [
    {
      "id": 123,
      "title": "ABAP SELECTの基本",
      "url": "https://sapjp.net/example/",
      "content": "SELECT文の基本...",
      "categories": ["ABAP"],
      "tags": ["SELECT"]
    }
  ],
  "citations": [
    {
      "id": 123,
      "title": "ABAP SELECTの基本",
      "url": "https://sapjp.net/example/"
    }
  ]
}

Topics

カテゴリ・タグから取得する

topics はカテゴリスラッグまたはタグスラッグで記事を取得します。 ABAP、SAP、S/4HANAなどの領域別ナレッジ一覧に使えます。

Request
curl "https://sapjp.net/wp-json/sapjp/v1/topics/abap?limit=5"

Safety

公開範囲

このAPIは通常の公開投稿だけを返します。下書き、非公開投稿、パスワード保護投稿はレスポンスに含めません。 WordPressをチャット実行基盤にせず、記事コンテンツの提供に役割を限定しています。

Next

MCP連携の次の形

1

外部MCPサーバーから /context を呼び出す。

2

GitHub上のABAPメモやコード例も同じ検索対象に加える。

3

別アプリ側でABAPレビューAIやSAP用語検索UIを提供する。