К основному содержанию
скилл CX Codex

semantic-search-cwicr — скилл для Claude Code

Скилл semantic-search-cwicr находит похожие позиции в строительных расценках DDC CWICR через векторный поиск на естественном языке. Работает с 8 национальными базами в 26 языках.

MIT 118 установок ★ 434 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill semantic-search-cwicr -a claude-code
Открыть на GitHub

Что делает semantic-search-cwicr

Скилл ищет работы в базах строительных расценок DDC CWICR — 78 228 позиций из Турции, Китая, Бразилии, Испании, Италии, Вьетнама, Индонезии и Греции. Использует эмбеддинги BAAI/bge-m3 (1024 измерения) и векторную базу Qdrant: каждому языку соответствует коллекция вида cwicr_{LANG}_v3. Возвращает код позиции, описание, единицу измерения, цену за единицу, классификацию и компоненты ресурсов.

Внутри Python-класс CWICRSemanticSearch: кодирует запрос через SentenceTransformer, ищет ближайших соседей в Qdrant, возвращает DataFrame с колонками rate_code, rate_original_name, total_cost_per_position и оценкой сходства. Можно фильтровать по категории работ или искать по BIM-элементам через API OpenConstructionERP (POST /api/v1/costs/suggest-for-element).

Требует Python3, переменную окружения QDRANT_URL и пакеты qdrant-client, pandas, sentence-transformers. Базы Вьетнама и Индонезии содержат коэффициенты (нулевые цены) — для получения реальной стоимости нужны рыночные таблицы ресурсов из каталогов markets/*.csv.

Какие задачи решает

  • найти работы для сметы по описанию на естественном языке
  • сопоставить позиции из разных региональных баз
  • получить unit-цены для элементов BIM-модели
  • искать расценки на 26 языках без перевода терминов
  • отфильтровать позиции по категории работ и вернуть компоненты

Примеры запросов агенту

  • Найди позиции для устройства армированного фундамента из турецкой базы TR_NATIONAL
  • Запусти семантический поиск tuğla duvar örülmesi в коллекции cwicr_tr_v3
  • Покажи компоненты ресурсов и стоимость для позиции 15.115.1008

Как установить semantic-search-cwicr

1Через Skills CLI (Vercel)

npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill semantic-search-cwicr -a claude-code

2Вручную: положить файлы

~/.claude/skills/semantic-search-cwicr/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/semantic-search-cwicr/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о semantic-search-cwicr

Как установить semantic-search-cwicr в Claude Code?

Выполни npx skills add datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction --skill semantic-search-cwicr -a claude-code, затем проверь файл ~/.claude/skills/semantic-search-cwicr/SKILL.md.

Что делает semantic-search-cwicr?

Ищет похожие строительные работы в базах расценок DDC CWICR (8 национальных баз, 78 228 позиций) через векторные эмбеддинги BGE-M3. Возвращает коды работ, описания, цены и компоненты ресурсов для сметного расчёта.

Почему базы Вьетнама и Индонезии показывают нулевые цены?

Эти базы содержат коэффициенты, а не абсолютные цены. Для получения реальной стоимости нужно загрузить рыночные таблицы ресурсов из каталогов markets/*.csv, которые идут вместе с релизом.

Исходный текст

SKILL.md · MIT
---
name: "semantic-search-cwicr"
description: "Semantic search in the DDC CWICR construction cost database using vector embeddings (BGE-M3, 1024-dim, per-language Qdrant collections). Find similar work items and resources for cost estimation across 8 national bases and 30 markets in 26 languages."
homepage: "https://datadrivenconstruction.io"
metadata: {"openclaw": {"emoji": "🗄️", "os": ["darwin", "linux", "win32"], "homepage": "https://datadrivenconstruction.io", "requires": {"bins": ["python3"], "env": ["QDRANT_URL"]}, "primaryEnv": "QDRANT_URL"}}
---

# Semantic Search in DDC CWICR Database

## Business Case

### Problem Statement
Construction cost estimation requires finding relevant work items from large databases. Traditional keyword search fails when:
- Users describe work in natural language
- Terminology varies across regions and languages
- Similar work items have different naming conventions

### Solution
DDC CWICR provides pre-computed embeddings (BAAI/bge-m3, 1024 dimensions) enabling multilingual semantic search across **8 national bases (78,228 positions)** plus the **30-market global base** in **26 languages**, with 48 PPP-repriced market catalogs per national base.

### Business Value
- **90% faster** work item lookup compared to manual search
- **Multi-language**: Arabic, Bulgarian, Chinese, Croatian, Czech, Danish, Dutch, English, Finnish, French, German, Hindi, Indonesian, Italian, Japanese, Korean, Mongolian, Norwegian, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Thai, Turkish, Vietnamese
- **Higher accuracy** by finding semantically similar items, not just keyword matches

## Data landscape (2026)

| National base | Region id | Positions |
|---|---|---|
| Turkey (Birim Fiyat) | `TR_NATIONAL` | 22,704 |
| China (Beijing Dinge + Bole) | `ZH_CHINA` | 11,312 |
| Brazil (SINAPI) | `BR_NATIONAL` | 9,723 |
| Spain (BCCA Andalucía) | `ES_ANDALUCIA` | 6,453 |
| Italy (Prezzario Toscana) | `IT_TOSCANA` | 5,836 |
| Vietnam (Dinh Muc) | `VN_NATIONAL` | 4,299 |
| Indonesia (AHSP) | `ID_NATIONAL` | 2,784 |
| Greece (GGDE) | `GR_NATIONAL` | 2,647 |

Each base ships the **95-column CWICR master schema** (`rate_code`, `rate_original_name`, `rate_final_name`, `rate_unit`, `total_cost_per_position`, classification hierarchy `collection/department/section/subsection/category`, `resource_*` component lines with `is_material/is_machine/is_labor` flags) plus 26 language editions and 48 `markets/*.csv` catalogs.

Latest data release: **v0.4.0** (see [releases](https://github.com/datadrivenconstruction/OpenConstructionEstimate-DDC-CWICR/releases)).

## Technical Implementation

### Prerequisites
```bash
pip install qdrant-client pandas sentence-transformers
```

### Collections (2026)

The vector store uses **BAAI/bge-m3** (1024-dim dense + sparse + colbert in one forward pass, MIT license, 100+ languages). Production collections are named `cwicr_{LANG}_v3` (e.g. `cwicr_tr_v3`, `cwicr_zh_v3`). An ONNX-int8 variant (`gpahal/bge-m3-onnx-int8`, ~700 MB) is used on VPS-sized hosts.

### Python Implementation

```python
import pandas as pd
from qdrant_client import QdrantClient
from sentence_transformers import SentenceTransformer

class CWICRSemanticSearch:
    def __init__(self, host="localhost", port=6333, lang="en"):
        self.client = QdrantClient(host=host, port=port)
        self.collection = f"cwicr_{lang}_v3"
        self.model = SentenceTransformer("BAAI/bge-m3")

    def search_work_items(self, query, limit=10):
        vec = self.model.encode(query).tolist()
        hits = self.client.search(
            collection_name=self.collection,
            query_vector=vec,
            limit=limit,
        )
        return pd.DataFrame([{**h.payload, "score": h.score} for h in hits])

    def search_by_category(self, query, category, limit=10):
        vec = self.model.encode(query).tolist()
        hits = self.client.search(
            collection_name=self.collection,
            query_vector=vec,
            query_filter={"must": [{"key": "category", "match": {"value": category}}]},
            limit=limit,
        )
        return pd.DataFrame([{**h.payload, "score": h.score} for h in hits])
```

### Inside OpenConstructionERP

The platform's `costs` module already exposes semantic matching:
- `POST /api/v1/costs/suggest-for-element` — rank cost items for a BIM element body.
- `/qdrant-search` — multilingual candidate retrieval for a query.
- The SQL fallback (`GET /api/v1/costs/?q=...`) works without Qdrant.

## Database Schema (95-column master)

Key fields the payload carries:

| Field | Type | Description |
|-------|------|-------------|
| `rate_code` | string | Unique work item code (e.g. `15.115.1008`) |
| `rate_original_name` | string | Source-language description |
| `rate_final_name` | string | Display/translated description |
| `rate_unit` | string | m², m³, m, kg, Ad, Sa… |
| `total_cost_per_position` | float | Total unit price |
| `total_resource_cost_per_position` | float | Resource sum (before markup) |
| `collection_name` / `department_name` / `section_name` / `subsection_name` | string | Classification hierarchy |
| `category_type` | string | Normalized category (e.g. `CONSTRUCTION WORK`) |
| `resource_name` / `resource_quantity` / `resource_price_per_unit_current` / `resource_cost` | mixed | Component lines |
| `is_material` / `is_machine` / `is_labor` | bool | Component nature flags |

## Usage Examples

### Basic Search
```python
search = CWICRSemanticSearch(lang="tr")

# Natural language query
results = search.search_work_items("tuğla duvar örülmesi")
print(results[["rate_code", "rate_original_name", "total_cost_per_position", "score"]])
```

### Cost Estimation
```python
# Find work items for foundation work
foundation = search.search_work_items("reinforced concrete foundation", limit=20)

# Estimate with quantities (BIM takeoff)
quantities = {"15.115.1008": 150.0}  # m³
total = sum(quantities[c] * row["total_cost_per_position"]
            for _, row in foundation.iterrows() if row["rate_code"] in quantities)
print(f"Estimated: {total:,.2f} TRY")
```

## Best Practices

1. **Use specific queries** - "reinforced concrete slab 200mm" beats "concrete"
2. **Filter by category** - Narrow results to relevant work types
3. **Check similarity scores** - Low scores need manual verification
4. **Combine with QTO** - Use BIM quantities for automated estimation
5. **Mind the coefficient bases** - Vietnam and Indonesia have no prices (rate 0); price them via a market resource sheet
6. **Trust the source column** - `rate_original_name` holds the source wording; translations live in `rate_final_name`

## Resources

- **GitHub**: [OpenConstructionEstimate-DDC-CWICR](https://github.com/datadrivenconstruction/OpenConstructionEstimate-DDC-CWICR)
- **Releases**: [v0.4.0](https://github.com/datadrivenconstruction/OpenConstructionEstimate-DDC-CWICR/releases)
- **Platform**: [OpenConstructionERP](https://github.com/datadrivenconstruction/OpenConstructionERP)
- **Qdrant Docs**: https://qdrant.tech/documentation/

© datadrivenconstruction · MIT · datadrivenconstruction/DDC_Skills_for_AI_Agents_in_Construction

Похожие скиллы

Все скиллы по теме «Данные и базы» →
Paparats – Local Semantic Code Search MCP IBazylchuk Paparats – Local Semantic Code Search MCP — MCP-сервер для Claude Code: ищет по смыслу в нескольких репозиториях и хранит архитектурную память проекта. Помогает агенту ориентироваться в незнакомой кодовой базе. CX Codex +1 ★ 35звёзд репо pgvector-semantic-search tigerdata Скилл pgvector-semantic-search учит агента настраивать векторный поиск в PostgreSQL с помощью pgvector. Он помогает хранить эмбеддинги, строить индексы HNSW и готовить базу к задачам RAG. CX Codex +1 1 000установок qdrant-vector-search Orchestra Research Скилл qdrant-vector-search для Claude Code помогает проектировать поиск по векторам в Qdrant для RAG и семантического поиска, включая фильтрацию по метаданным и масштабирование. CX Codex +1 1 100установок sqry - Semantic Code Search verivus-oss MCP-сервер sqry - Semantic Code Search с семантическим поиском по коду на основе AST: находит символы, связи и последствия правок в 37 языках. CX Codex +1 ★ 31звёзд репо rag-architect https://github.com/Jeffallan Скилл rag-architect проектирует RAG-системы: разбивает документы на чанки, генерирует эмбеддинги, настраивает векторные базы, строит гибридный поиск и оценивает качество извлечения контекста. CX Codex +1 5 100установок postgres-semantic-search laguagu Скилл postgres-semantic-search для Claude Code настраивает поиск и извлечение данных в PostgreSQL. Помогает собрать семантический или гибридный поиск, оценить качество результатов и разобраться со слабыми совпадениями. CX Codex +1 227установок

Из того же набора156

Весь набор →
data-source-audit Скилл data-source-audit разбирает системы, из которых проект получает данные: находит изолированные инструменты, домены без мастер-источника и собирает план интеграций. CX Codex +1 118установок continuous-learning-construction Скилл continuous-learning-construction извлекает из сессий по строительной автоматизации решения и повторно используемые шаблоны. Пригодится после расчётов, обработки документов и настройки интеграций. CX Codex +1 118установок cwicr-schedule-integrator Скилл cwicr-schedule-integrator связывает расценки CWICR с календарным графиком: считает бюджет активностей, раскладывает его по дням и строит денежный поток с метриками освоенного объёма. CX Codex +1 118установок data-evolution-analysis Скилл data-evolution-analysis оценивает цифровую зрелость строительной компании по методике DDC от бумажного документооборота до предиктивной аналитики. Помогает составить дорожную карту цифровизации. CX Codex +1 118установок cwicr-risk-calculator Скилл cwicr-risk-calculator рассчитывает сметные риски и надбавки на непредвиденные расходы в строительстве с помощью симуляций Монте-Карло. CX Codex +1 118установок nobim-image-generator Скилл nobim-image-generator для Claude Code строит визуализации BIM-данных без BIM-программы. Запускается по запросу создать изображения или схемы из Revit- или IFC-модели. CX Codex +1 117установок schedule-cost-link Скилл schedule-cost-link связывает работы из графика стройки с позициями сметы, строит денежные потоки и считает освоение по методу EV. CX Codex +1 117установок payment-application-generator Скилл payment-application-generator генерирует платёжные заявки в формате AIA: ведёт график стоимости работ, считает удержания и выводит документы для оплаты. CX Codex +1 117установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой