> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> الصفحات وقواعد البيانات وقواعد المعرفة في Notion

# الصفحات وقواعد البيانات

يربط تكامل Notion تطبيق وولف فيش بمساحة عمل Notion للبحث والقراءة والإنشاء والاستعلام في الصفحات وقواعد البيانات. يستخدم رمز تكامل Notion الداخلي للمصادقة.

## الإعداد

<Steps>
  <Step title="إنشاء تكامل">
    انتقل إلى [notion.so/my-integrations](https://www.notion.so/my-integrations) واضغط "تكامل جديد". أعطه اسمًا (مثل "وولف فيش") واختر مساحة العمل.
  </Step>

  <Step title="نسخ الرمز">
    بعد الإنشاء، انسخ رمز التكامل الداخلي (يبدأ بـ `ntn_` أو `secret_`).
  </Step>

  <Step title="التهيئة في وولف فيش">
    افتح الإعدادات > التكاملات > Notion والصق الرمز.
  </Step>

  <Step title="مشاركة الصفحات مع التكامل">
    في Notion، افتح كل صفحة أو قاعدة بيانات تريد أن يصل إليها وولف فيش. اضغط قائمة "..." > "الاتصالات" > ابحث عن تكاملك واربطه.
  </Step>
</Steps>

<Warning>
  لا يمكن للتكامل الوصول إلا إلى الصفحات وقواعد البيانات التي شُوركت معه صراحةً. إذا لم يتمكن وولف فيش من إيجاد صفحة، تحقق من أن اتصالات الصفحة تتضمن تكاملك.
</Warning>

## الأدوات المتاحة

### البحث والقراءة

| الأداة               | الوصف                                                   |
| -------------------- | ------------------------------------------------------- |
| `notion_search`      | البحث في الصفحات وقواعد البيانات بالعنوان أو المحتوى    |
| `notion_read_page`   | قراءة خصائص الصفحة (العنوان، التواريخ، الوسوم، إلخ)     |
| `notion_read_blocks` | قراءة محتوى كتل الصفحة (فقرات، قوائم، شفرة برمجية، إلخ) |

### الإنشاء والتحديث

| الأداة                 | الوصف                                       |
| ---------------------- | ------------------------------------------- |
| `notion_create_page`   | إنشاء صفحة جديدة في صفحة أب أو قاعدة بيانات |
| `notion_update_page`   | تحديث خصائص الصفحة                          |
| `notion_append_blocks` | إلحاق كتل جديدة بنهاية الصفحة               |

### قواعد البيانات

| الأداة                   | الوصف                                 |
| ------------------------ | ------------------------------------- |
| `notion_create_database` | إنشاء قاعدة بيانات جديدة بخصائص محددة |
| `notion_query_database`  | استعلام قاعدة بيانات بفلاتر وترتيب    |
| `notion_add_comment`     | إضافة تعليق على صفحة أو نقاش          |

## الاستعلام في قواعد البيانات

تدعم أداة `notion_query_database` صيغة الفلترة والترتيب في Notion:

```json theme={null}
{
  "database_id": "abc123...",
  "filter": {
    "property": "Status",
    "status": {
      "equals": "In Progress"
    }
  },
  "sorts": [
    {
      "property": "Priority",
      "direction": "descending"
    }
  ]
}
```

الفلاتر المركّبة مدعومة:

```json theme={null}
{
  "filter": {
    "and": [
      {
        "property": "Status",
        "status": { "equals": "In Progress" }
      },
      {
        "property": "Assignee",
        "people": { "contains": "user-id-here" }
      }
    ]
  }
}
```

<Tip>
  لا تحتاج لكتابة JSON الفلترة الخام بنفسك. فقط صِف ما تريده — "أرني المهام المسندة إليّ التي قيد التنفيذ" — وسيبني النموذج اللغوي الفلتر المناسب.
</Tip>

## أنواع الكتل المدعومة

عند إنشاء أو إلحاق محتوى، يدعم وولف فيش أنواع كتل Notion التالية:

| نوع الكتلة           | الوصف                                 |
| -------------------- | ------------------------------------- |
| `paragraph`          | فقرة نصية عادية                       |
| `heading_1`          | عنوان كبير                            |
| `heading_2`          | عنوان متوسط                           |
| `heading_3`          | عنوان صغير                            |
| `bulleted_list_item` | عنصر قائمة نقطية                      |
| `numbered_list_item` | عنصر قائمة مرقّمة                     |
| `toggle`             | كتلة قابلة للطي                       |
| `code`               | كتلة شفرة برمجية مع تلوين بناء الجملة |
| `quote`              | اقتباس                                |
| `callout`            | تنبيه مع أيقونة                       |
| `divider`            | فاصل أفقي                             |
| `table`              | كتلة جدول                             |
| `bookmark`           | رابط محفوظ                            |

## المحفّزات

تُفعّل قدرة Notion عندما تتطابق رسالتك مع أي من هذه الأنماط:

```
notion, workspace, wiki, knowledge base,
database, page, kanban, board, backlog,
sprint, project tracker, notes
```

## أمثلة على سير العمل

<AccordionGroup>
  <Accordion title="البحث في مساحة العمل">
    ```
    You: "Search my Notion for the API spec"
    Wolffish: Calls notion_search with "API spec" and returns matching pages
    with titles and parent locations.
    ```
  </Accordion>

  <Accordion title="إضافة صفحة إلى قاعدة بيانات">
    ```
    You: "Add a new task to my project database: implement login flow, priority high"
    Wolffish: Calls notion_create_page with the database as parent and sets
    the Title, Status, and Priority properties.
    ```
  </Accordion>

  <Accordion title="استعلام المهام قيد التنفيذ">
    ```
    You: "What tasks are in progress?"
    Wolffish: Calls notion_query_database with a Status = "In Progress" filter
    and returns matching entries with their properties.
    ```
  </Accordion>

  <Accordion title="إلحاق محتوى بصفحة">
    ```
    You: "Add a section about error handling to my API documentation page"
    Wolffish: Searches for the page, then calls notion_append_blocks with
    heading and paragraph blocks containing the new content.
    ```
  </Accordion>
</AccordionGroup>

## مرجع التهيئة

يُخزّن رمز Notion كمتغير في الإعدادات:

```json theme={null}
{
  "variables": {
    "NOTION_TOKEN": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}
```

بدلًا من ذلك، في `config.json`:

```json theme={null}
{
  "integrations": {
    "notion": {
      "token": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
}
```

<Info>
  واجهة Notion API لديها حدود استخدام (3 طلبات في الثانية للتكاملات). يتعامل وولف فيش مع إعادة المحاولات بتأخير تصاعدي تلقائيًا عبر وحدة `motor`. إذا كنت تجري عمليات جماعية، قد تكون الاستجابات أبطأ قليلًا من المعتاد.
</Info>

<Warning>
  لا تشارك أبدًا رمز تكامل Notion. أي شخص يملك الرمز يمكنه قراءة وتعديل جميع الصفحات التي يملك التكامل صلاحية الوصول إليها. إذا اشتبهت بتسرّب الرمز، قم بتدويره فورًا في [notion.so/my-integrations](https://www.notion.so/my-integrations).
</Warning>