provider-search

name	provider-search
description	福祉サービス事業所の検索・管理・口コミ評価を行うスキル。WAM NETから取得した事業所情報（ServiceProvider）と支援者による口コミ（ProviderFeedback）をNeo4jグラフデータベースで管理する。汎用neo4j MCPツールでCypherクエリを実行。

provider-search スキル

概要

福祉サービス事業所の検索・管理・口コミ評価を行うスキル。WAM NETから取得した事業所情報（ServiceProvider）と支援者による口コミ（ProviderFeedback）をNeo4jグラフデータベースで管理する。

対象Neo4jインスタンス

• support-db: bolt://localhost:7687（HTTP: 7474）
• neo4j MCPの read_neo4j_cypher / write_neo4j_cypher を使用

データモデル

ノード

ServiceProvider（福祉サービス事業所）

重要: WAM NETインポート時期により2種類のプロパティ命名規則が混在している。

新形式（camelCase）	旧形式（snake_case）	説明	件数目安
name	office_name	事業所名	新1002件 / 旧128件 / 空1496件
corporateName	corp_name	法人名
serviceType	service_type	サービス種類
city	―	市区町村	両形式共通
address	address	住所	両形式共通
phone	phone	電話番号	両形式共通
fax	―	FAX番号
fullAddress	―	完全住所	新形式のみ
postalCode	―	郵便番号	新形式のみ
capacity	―	定員	約1084件のみ
currentUsers	―	現在利用者数	ほぼ未設定
availability	―	空き状況	997件が'未確認'、残りはnull
targetDisability	―	対象障害種別	ほぼ未設定
features	―	特色・特徴	ほぼ未設定
closedDays	closed_days	休日
hoursWeekday	hours_weekday	平日営業時間
hoursSaturday	―	土曜営業時間	新形式のみ
hoursSunday	―	日曜営業時間	新形式のみ
hoursHoliday	―	祝日営業時間	新形式のみ
providerId	office_number	WAM NET事業所番号
wamnetId	―	WAM NET ID	新形式のみ
prefecture	―	都道府県	新形式のみ
municipalityCode	city_code	市区町村コード
serviceTypeCode	―	サービス種類コード	新形式のみ
serviceCategory	―	サービスカテゴリ	新形式のみ
latitude	latitude	緯度	両形式共通
longitude	longitude	経度	両形式共通
url	―	Webサイト	新形式のみ
dataSource	data_source	データソース（WAM_NET）
updatedAt	updated_at	最終更新日

名前解決パターン: 事業所名の表示には必ず以下のCOALESCEを使うこと:

COALESCE(sp.name, sp.office_name, sp.corporateName, sp.corp_name, '名称未登録') AS displayName

サービス種類の解決:

COALESCE(sp.serviceType, sp.service_type, '') AS serviceType

ProviderFeedback（口コミ・評価）

プロパティ	型	説明
feedbackId	String	フィードバックID（UUID）
category	String	カテゴリ（行動障害対応/コミュニケーション/環境/送迎/食事/医療連携/その他）
content	String	口コミ内容
rating	String	評価（◎良い / ○普通 / △課題あり / ×不可）
source	String	情報源（支援者名 or 匿名）
date	String	登録日（ISO形式）
isConfirmed	Boolean	確認済みフラグ

注意: ProviderFeedbackノードは運用で登録するもの。初期状態では0件。

リレーションシップ

(:Client)-[:USES_SERVICE {startDate, endDate, status, note}]->(:ServiceProvider)
(:ServiceProvider)-[:HAS_FEEDBACK]->(:ProviderFeedback)

USES_SERVICE プロパティ:

• startDate: 利用開始日
• endDate: 利用終了日
• status: Active（利用中）/ Pending（調整中）/ Ended（利用終了）
• note: 備考

注意: USES_SERVICE関係も運用で作成するもの。初期状態では0件。

評価スコア換算

rating	スコア
◎良い	4
○普通	3
△課題あり	2
×不可	1

データ統計（2026年1月時点）

項目	件数
ServiceProvider総数	2621
名前あり（新形式）	1002
名前あり（旧形式）	128
名前なし	1496
capacity設定済み	1084
availability設定済み	997（すべて'未確認'）
ProviderFeedback	0（運用後に蓄積）
USES_SERVICE関係	0（運用後に作成）

Cypherテンプレート

── 読み取り系（read_neo4j_cypher） ──

テンプレート1: 事業所検索（基本）

サービス種類・地域で絞り込む。名前があるレコードのみ返す。 条件は任意で組み合わせ可能（不要なWHERE行を削除して使う）。

MATCH (sp:ServiceProvider)
WHERE (sp.name IS NOT NULL AND sp.name <> '')
  AND COALESCE(sp.serviceType, sp.service_type, '') CONTAINS $serviceType
  AND sp.city CONTAINS $city
RETURN COALESCE(sp.name, sp.office_name) AS name,
       COALESCE(sp.corporateName, sp.corp_name, '') AS corporateName,
       COALESCE(sp.serviceType, sp.service_type, '') AS serviceType,
       sp.city AS city,
       COALESCE(sp.address, sp.fullAddress, '') AS address,
       sp.phone AS phone,
       sp.capacity AS capacity,
       COALESCE(sp.availability, '未確認') AS availability,
       COALESCE(sp.closedDays, sp.closed_days, '') AS closedDays,
       sp.hoursWeekday AS hoursWeekday
ORDER BY
  CASE COALESCE(sp.availability, '未確認')
    WHEN '空きあり' THEN 1
    WHEN '要相談' THEN 2
    WHEN '未確認' THEN 3
    WHEN '満員' THEN 4
    ELSE 5
  END,
  COALESCE(sp.name, sp.office_name)
LIMIT $limit

使い方: 条件を自由に組み合わせる。

• サービス種類のみ: AND COALESCE(sp.serviceType, sp.service_type, '') CONTAINS '生活介護' のWHERE行のみ残す
• 地域のみ: AND sp.city CONTAINS '北九州' のWHERE行のみ残す
• キーワード検索追加: AND (COALESCE(sp.name, sp.office_name, '') CONTAINS $keyword OR COALESCE(sp.corporateName, sp.corp_name, '') CONTAINS $keyword)
• 空き状況絞り込み: AND COALESCE(sp.availability, '未確認') = '空きあり'
• 旧形式も含める: WHERE (sp.name IS NOT NULL AND sp.name <> '') OR (sp.office_name IS NOT NULL AND sp.office_name <> '')

パラメータ:

• $serviceType: サービス種類（部分一致、例: '生活介護', 'グループホーム', '就労継続支援B型'）
• $city: 市区町村（部分一致、例: '北九州', '久留米'）
• $limit: 取得件数（デフォルト20）

テンプレート2: クライアントの利用事業所一覧

MATCH (c:Client)-[r:USES_SERVICE]->(sp:ServiceProvider)
WHERE c.name CONTAINS $clientName
RETURN COALESCE(sp.name, sp.office_name, sp.corporateName, '名称未登録') AS providerName,
       COALESCE(sp.serviceType, sp.service_type, '') AS serviceType,
       sp.phone AS phone,
       r.status AS status,
       r.startDate AS startDate,
       r.endDate AS endDate,
       r.note AS note
ORDER BY
  CASE r.status
    WHEN 'Active' THEN 1
    WHEN 'Pending' THEN 2
    WHEN 'Ended' THEN 3
    ELSE 4
  END,
  r.startDate DESC

パラメータ:

• $clientName: クライアント名（部分一致）

注意: USES_SERVICE関係が存在しない場合は空の結果が返る。

テンプレート3: 代替事業所検索

現在利用中のサービスと同種の事業所で、まだ利用していないものを検索する。

MATCH (c:Client)-[r:USES_SERVICE]->(current:ServiceProvider)
WHERE c.name CONTAINS $clientName
  AND r.status = 'Active'
WITH c, collect(COALESCE(current.name, current.office_name)) AS currentNames,
     collect(DISTINCT COALESCE(current.serviceType, current.service_type)) AS serviceTypes
UNWIND serviceTypes AS st
MATCH (alt:ServiceProvider)
WHERE COALESCE(alt.serviceType, alt.service_type, '') = st
  AND COALESCE(alt.name, alt.office_name, '') <> ''
  AND NOT COALESCE(alt.name, alt.office_name) IN currentNames
RETURN COALESCE(alt.name, alt.office_name) AS name,
       COALESCE(alt.corporateName, alt.corp_name, '') AS corporateName,
       COALESCE(alt.serviceType, alt.service_type, '') AS serviceType,
       alt.city AS city,
       alt.phone AS phone,
       COALESCE(alt.availability, '未確認') AS availability,
       alt.capacity AS capacity
ORDER BY
  CASE COALESCE(alt.availability, '未確認')
    WHEN '空きあり' THEN 1
    WHEN '要相談' THEN 2
    WHEN '未確認' THEN 3
    WHEN '満員' THEN 4
    ELSE 5
  END,
  COALESCE(alt.name, alt.office_name)
LIMIT 20

パラメータ:

• $clientName: クライアント名（部分一致）

テンプレート4: 事業所の口コミ取得

MATCH (sp:ServiceProvider)-[:HAS_FEEDBACK]->(f:ProviderFeedback)
WHERE COALESCE(sp.name, sp.office_name, sp.corporateName, '') CONTAINS $providerName
RETURN f.category AS category,
       f.content AS content,
       f.rating AS rating,
       f.source AS source,
       f.date AS date
ORDER BY f.date DESC
LIMIT $limit

パラメータ:

• $providerName: 事業所名（部分一致）
• $limit: 取得件数（デフォルト20）

カテゴリ絞り込み: AND f.category = $category をWHEREに追加。

テンプレート5: 事業所の評価サマリー

MATCH (sp:ServiceProvider)-[:HAS_FEEDBACK]->(f:ProviderFeedback)
WHERE COALESCE(sp.name, sp.office_name, sp.corporateName, '') CONTAINS $providerName
WITH sp,
     count(f) AS totalFeedbacks,
     sum(CASE WHEN f.rating STARTS WITH '◎' THEN 1 ELSE 0 END) AS excellent,
     sum(CASE WHEN f.rating STARTS WITH '○' THEN 1 ELSE 0 END) AS good,
     sum(CASE WHEN f.rating STARTS WITH '△' THEN 1 ELSE 0 END) AS fair,
     sum(CASE WHEN f.rating STARTS WITH '×' THEN 1 ELSE 0 END) AS poor,
     avg(CASE
       WHEN f.rating STARTS WITH '◎' THEN 4.0
       WHEN f.rating STARTS WITH '○' THEN 3.0
       WHEN f.rating STARTS WITH '△' THEN 2.0
       WHEN f.rating STARTS WITH '×' THEN 1.0
       ELSE 0.0
     END) AS avgScore
RETURN COALESCE(sp.name, sp.office_name, sp.corporateName) AS providerName,
       totalFeedbacks,
       excellent, good, fair, poor,
       round(avgScore * 100) / 100 AS avgScore

パラメータ:

• $providerName: 事業所名（部分一致）

テンプレート6: 口コミ評価で事業所検索

特定カテゴリの口コミが良い事業所を探す。

MATCH (sp:ServiceProvider)-[:HAS_FEEDBACK]->(f:ProviderFeedback)
WHERE f.category = $category
WITH sp,
     count(f) AS feedbackCount,
     avg(CASE
       WHEN f.rating STARTS WITH '◎' THEN 4.0
       WHEN f.rating STARTS WITH '○' THEN 3.0
       WHEN f.rating STARTS WITH '△' THEN 2.0
       WHEN f.rating STARTS WITH '×' THEN 1.0
       ELSE 0.0
     END) AS avgScore,
     collect(f.content)[0..3] AS topExamples
WHERE feedbackCount >= 1
RETURN COALESCE(sp.name, sp.office_name, sp.corporateName) AS providerName,
       COALESCE(sp.serviceType, sp.service_type, '') AS serviceType,
       sp.city AS city,
       COALESCE(sp.availability, '未確認') AS availability,
       feedbackCount,
       round(avgScore * 100) / 100 AS avgScore,
       topExamples
ORDER BY avgScore DESC, feedbackCount DESC
LIMIT $limit

パラメータ:

• $category: 口コミカテゴリ（行動障害対応/コミュニケーション/環境/送迎/食事/医療連携）
• $limit: 取得件数（デフォルト20）

追加フィルタ:

• 評価絞り込み: AND f.rating STARTS WITH '◎'
• サービス種類: AND COALESCE(sp.serviceType, sp.service_type, '') CONTAINS $serviceType
• 地域: AND sp.city CONTAINS $city

── 書き込み系（write_neo4j_cypher） ──

テンプレート7: クライアントと事業所の紐付け

MERGE (c:Client {name: $clientName})
MERGE (sp:ServiceProvider {name: $providerName})
MERGE (c)-[r:USES_SERVICE]->(sp)
ON CREATE SET
  r.startDate = $startDate,
  r.status = $status,
  r.note = $note
ON MATCH SET
  r.status = $status,
  r.note = $note,
  r.endDate = CASE WHEN $status = 'Ended' THEN toString(date()) ELSE r.endDate END
RETURN c.name AS client, sp.name AS provider, r.status AS status, r.startDate AS startDate

パラメータ:

• $clientName: クライアント名
• $providerName: 事業所名（既存のServiceProvider.nameと完全一致させること）
• $startDate: 利用開始日（YYYY-MM-DD、空の場合は事前にdate().toString()をセット）
• $status: 利用状況（Active / Pending / Ended、デフォルト: Active）
• $note: 備考（任意）

注意: MERGE (sp:ServiceProvider {name: $providerName}) で名前完全一致が必要。事前にテンプレート1で正確な名前を確認すること。

テンプレート8: 口コミ・評価の登録

MATCH (sp:ServiceProvider)
WHERE COALESCE(sp.name, sp.office_name, sp.corporateName, '') CONTAINS $providerName
WITH sp LIMIT 1
CREATE (f:ProviderFeedback {
  feedbackId: randomUUID(),
  category: $category,
  content: $content,
  rating: $rating,
  source: $source,
  date: toString(date()),
  isConfirmed: false
})
CREATE (sp)-[:HAS_FEEDBACK]->(f)
RETURN COALESCE(sp.name, sp.office_name, sp.corporateName) AS provider,
       f.feedbackId AS feedbackId,
       f.category AS category,
       f.rating AS rating

パラメータ:

• $providerName: 事業所名（部分一致で最初の1件にマッチ）
• $category: カテゴリ（行動障害対応/コミュニケーション/環境/送迎/食事/医療連携/その他）
• $content: 口コミ内容
• $rating: 評価（◎良い / ○普通 / △課題あり / ×不可、デフォルト: ○普通）
• $source: 情報源（支援者名 or 匿名、デフォルト: 匿名）

テンプレート9: 事業所の空き状況更新

MATCH (sp:ServiceProvider)
WHERE COALESCE(sp.name, sp.office_name, sp.corporateName, '') CONTAINS $providerName
WITH sp LIMIT 1
SET sp.availability = $availability,
    sp.updatedAt = toString(datetime())
WITH sp, $currentUsers AS newUsers
FOREACH (_ IN CASE WHEN newUsers >= 0 THEN [1] ELSE [] END |
  SET sp.currentUsers = newUsers
)
RETURN COALESCE(sp.name, sp.office_name, sp.corporateName) AS provider,
       sp.availability AS availability,
       sp.currentUsers AS currentUsers,
       sp.updatedAt AS updatedAt

パラメータ:

• $providerName: 事業所名（部分一致で最初の1件にマッチ）
• $availability: 空き状況（空きあり / 要相談 / 満員 / 未確認）
• $currentUsers: 現在利用者数（-1の場合は更新しない）

運用ガイドライン

検索のベストプラクティス

1. 名前付きレコードのみ検索: 最初のWHERE句に sp.name IS NOT NULL AND sp.name <> '' を入れる
2. 旧形式も含める場合: (sp.name <> '' OR sp.office_name <> '') に変更
3. COALESCEを必ず使う: 表示名とサービス種類は両形式に対応するCOALESCEが必須
4. 空き優先ソート: availability は null が多いため COALESCE(sp.availability, '未確認') でnull安全に
5. LIMIT必須: 2621件のデータがあるため必ずLIMITを付ける

口コミ評価のカテゴリ

カテゴリ	観点
行動障害対応	パニック・他害・自傷等への対応力
コミュニケーション	意思疎通の工夫、家族との連携
環境	施設設備、衛生、バリアフリー
送迎	送迎の柔軟性、時間帯、対応範囲
食事	食事の質、アレルギー対応、嚥下配慮
医療連携	医療機関との連携、服薬管理
その他	上記に当てはまらないもの

サービス種類一覧（主要なもの）

サービス種類	件数
就労継続支援B型	494
生活介護	329
計画相談支援	325
放課後等デイサービス	299
グループホーム	174
共同生活援助	167
重度訪問介護	138
障害児相談支援	127
同行援護	88

注意事項

• データ混在: 新形式（camelCase）と旧形式（snake_case）が混在。テンプレートのCOALESCEパターンを必ず使うこと
• 名前なしレコード: 約1500件は名前が空。検索時は名前のフィルタを入れること
• availability: 初期状態では 'または null。運用中にテンプレート9で更新する
• ProviderFeedback: 初期状態では0件。運用中にテンプレート8で蓄積する
• USES_SERVICE: 初期状態では0件。運用中にテンプレート7で作成する