إعداد Sweepy

ثبّت Sweepy. الآن تحتاج إلى ملف تعريفي.

يحدد ملف التهيئة التعريفي لـ Sweepy الوظائف التي يبحث عنها والسيرة الذاتية التي يحتسب التطابق مقابلها. ويحدد أيضًا موقعك المستهدف.

الملف التعريفي ملف نصي صغير بصيغة YAML. ينظّم YAML، الذي يُلفظ مثل كلمة camel، البيانات عبر الإزاحة والنقطتين وفواصل الأسطر. لا تحتاج إلى كتابة شيفرة: إذا كنت تقرأ قائمة تسوق، فأنت تقرأ YAML.

الخيار أ: شغّل معالج الإعداد التفاعلي

ينشئ معالج الإعداد ملفًا تعريفيًا صالحًا من إجابات بسيطة. يفتح منصة إطلاق البحث قبل الاستبيان، ويكتب ملف التهيئة لك.

نفّذ هذا الأمر:

الطرفية
sweepy --setup

يطبع المعالج شعاره، ثم منصة الإطلاق. يعرض سطر الحالة تحت اللوحات الملف التعريفي المحمّل، مثل Current profile: Alex Rivera / 4 titles / Ready. وعندما لا يكون هناك ملف محمّل بعد، يقرأ Current profile: none loaded / build one to start.

تعرض منصة الإطلاق ست لوحات. Launch Sweep يشغّل الملف التعريفي المحمّل. Load Profile يفتح بحثًا محفوظًا. Build Profile يبدأ بحثًا جديدًا ويطرح أسئلة بلغة بسيطة. Sweep Settings يتحكم في الترتيب والبطاقات والسجل. Sweepy's Toolbox يضم تحرير الملف التعريفي وإدارة المحرك وإدارة المجمّعات ومفتاح التصحيح والمساعدة وأحدث السجلات وتحويل المستندات والتحديثات. Exit Sweepy يحفظ تغييراتك ويغلق المعالج.

يسرد مرجع الأوامر المفاتيح خلف كل إدخال.

إليك مخرجات الطرفية من أول جلسة معالج لأليكس، والتي تسلك مسار Build Profile:

Launchpad
╭────────────────────────────────────────────────────────────────────────────╮
│  SWEEPY  /  SEARCH LAUNCHPAD                                               │
├────────────────────────────────────────────────────────────────────────────┤
│  ╭────────────────────────────────╮   ╭────────────────────────────────╮   │
│  │ 01  LAUNCH SWEEP               │   │ 04  BUILD PROFILE              │   │
│  │ Run your job search now        │   │ Set up your job search         │   │
│  ╰────────────────────────────────╯   ╰────────────────────────────────╯   │
│  ╭────────────────────────────────╮   ╭────────────────────────────────╮   │
│  │ 02  LOAD PROFILE               │   │ 05  SWEEP SETTINGS             │   │
│  │ Open a search you saved        │   │ Ranking, cards, tracking       │   │
│  ╰────────────────────────────────╯   ╰────────────────────────────────╯   │
│  ╭────────────────────────────────╮   ╭────────────────────────────────╮   │
│  │ 03  SWEEPY'S TOOLBOX           │   │ 06  EXIT SWEEPY                │   │
│  │ Edit profile, logs, help       │   │ Save changes and close         │   │
│  ╰────────────────────────────────╯   ╰────────────────────────────────╯   │
├────────────────────────────────────────────────────────────────────────────┤
│  Current profile: none loaded  /  build one to start                       │
│  ↑ ↓ ← → navigate   Enter select   Esc exit                                │
╰────────────────────────────────────────────────────────────────────────────╯

أسئلة الملف التعريفي
Selected: 04  BUILD PROFILE

What is your name? Alex Rivera
What job titles are you looking for?
  (Separate multiple titles with a comma)
  > Paralegal, Legal Assistant, Litigation Support Specialist, Legal Secretary

Where do you want to work? (City, State): New York, NY

Do you want to see remote-only roles? (yes/no): no

Do you want to include hybrid roles? (yes/no): yes

What is the path to your resume PDF?
  Hint: In File Explorer, select the file and press Ctrl+Shift+C (Windows 11); on older Windows, Shift+right-click and pick Copy as path.
  > Alex_Rivera_Resume.pdf

What is your minimum target salary? (Leave blank to skip): 65000

Which platforms do you want to search?
  [x] Greenhouse
  [x] Ashby
  [x] Lever
  [x] Workable
  [ ] Aggregator feeds (Remotive, Adzuna)

Do you want to add custom platforms or ATS domains? (yes/no): yes

Enter custom platform names and domains (format: Name:domain.com, comma-separated):
  e.g. SmartRecruiters:smartrecruiters.com, Breezy HR:breezy.hr
  > SmartRecruiters:smartrecruiters.com, Breezy HR:breezy.hr

Enter must-have skills or keywords to prioritize (comma-separated, leave blank to extract from resume): Westlaw, LexisNexis, e-discovery, Contract Review, Legal Research

What export formats do you want?
  [x] PDF Report
  [x] CSV Spreadsheet
  [ ] JSON Data

Add job-tracking columns to the CSV? (date applied, status, interview stage, offer, follow-up date, contact, notes): (yes/no): yes

Do you want to configure multiple resume tracks (e.g. Tech Writer vs UX Writer)? (yes/no): no

Enable debug logging? (Logs are saved under logs/ in the application directory): (yes/no): no

What would you like to do?
  1. Submit profile
  2. Edit an answer
  3. Toggle job tracking columns
  4. Manage job engines
  5. Adjust engine performance
  6. Download job engines
  7. Convert a document to PDF (bonus)
  8. Show help
  9. Show recent logs
  10. Start over

تلميح

أعد تشغيل sweepy --setup في أي وقت لإنشاء ملف تعريفي جديد أو تحرير ملف قائم. يكتب المعالج في الملف الذي يسميه، ويترك ملفاتك التعريفية الأخرى دون تغيير.

لتجاوز منصة الإطلاق وتحرير ملف تعريفي محفوظ مباشرة، مرّر المفتاح --profile:

الطرفية
sweepy --setup --profile profiles/paralegal_nyc.yaml

الخيار ب: حرّر ملف التهيئة يدويًا

لكتابة إعداداتك مباشرة، انسخ القالب النموذجي وافتحه في محرر نصوص بسيط مثل Notepad أو VS Code. تجنب معالجات النصوص، لأنها تستبدل علامات الاقتباس المستقيمة بعلامات مقوسة وتفسد YAML.

Windows
macOS / Linux

الطرفية
copy config.sample.yaml profiles\alex_rivera_paralegal.yaml
notepad profiles\alex_rivera_paralegal.yaml

الطرفية
cp config.sample.yaml profiles/alex_rivera_paralegal.yaml
open profiles/alex_rivera_paralegal.yaml    # macOS
# or: nano profiles/alex_rivera_paralegal.yaml   # Linux

ملف أليكس التعريفي

يكتب المعالج هذا الملف إلى profiles/alex_rivera_paralegal.yaml. الأسطر التي تبدأ بـ # تعليقات: تشرح كل إعداد، ويتجاهلها Sweepy. ويملأ Sweepy قيمة افتراضية لأي قسم أو إعداد تتركه.

profiles/alex_rivera_paralegal.yaml
# ─────────────────────────────────────────────────
# Sweepy — Alex's Paralegal Profile
# ─────────────────────────────────────────────────

# Your name (appears in the PDF report header)
name: "Alex Rivera"

# ─── Job Search Settings ──────────────────────────
search:
  # List every job title you want to find.
  # The engine searches for ALL of these titles simultaneously.
  titles:
    - "Paralegal"
    - "Legal Assistant"
    - "Litigation Support Specialist"
    - "Legal Secretary"

  # Your target city and state.
  location: "New York, NY"

  # Set to true to ONLY see remote roles.
  # Set to false to see remote, hybrid, and on-site roles.
  remote_only: false

  # Set to false to exclude hybrid positions.
  include_hybrid: true

  # Minimum annual salary filter (optional).
  # Leave as 0 or remove this line to skip salary filtering.
  min_salary: 65000

# ─── Resume Settings ─────────────────────────────
resume:
  # The full path to your resume PDF on your computer.
  # On Windows, use double backslashes (\\) or forward slashes (/).
  path: "Alex_Rivera_Resume.pdf"

  # Must-have skills to prioritize for the match percentage.
  must_have_skills:
    - "Westlaw"
    - "LexisNexis"
    - "e-discovery"
    - "Contract Review"
    - "Legal Research"

  # How heavily to weigh keyword matches when scoring roles.
  # 1.0 = standard weight. Increase to 2.0 if you want
  # exact skill matches to dominate the score.
  keywords_weight: 1.5

# ─── Platform Settings ────────────────────────────
# Set each platform to true or false to enable or disable it.
platforms:
  greenhouse: true
  ashby: true
  lever: true
  workable: true
  aggregators: false   # Free feeds like Remotive, Adzuna

  # Optional: custom ATS endpoints or company career domains
  custom:
    - name: "SmartRecruiters"
      domain: "smartrecruiters.com"
      enabled: true
    - name: "Breezy HR"
      domain: "breezy.hr"
      enabled: true

# ─── Export Settings ──────────────────────────────
export:
  # Comma-separated list of output formats.
  # Options: pdf, csv, json
  format: "pdf,csv"

  # Where to save the output files.
  # The engine creates this folder if it does not exist.
  output_dir: "results"

حذر

على Windows: استخدم شرطتين مائلتين عكسيتين (\\) أو شرطتين مائلتين (/) في مسارات YAML. الشرطة المائلة العكسية الواحدة (\) تفسد تنسيق YAML.

✅ صحيح: "C:\\Users\\Alex\\Documents\\resume.pdf" أو "C:/Users/Alex/Documents/resume.pdf"

❌ غير صحيح: "C:\Users\Alex\Documents\resume.pdf"

استخدام ملفات تعريفية جاهزة

يتضمن Sweepy ملفات تعريفية جاهزة للاستخدام في مجلد profiles/. تغطي هذه الملفات الأربعة عمليات بحث شائعة:

الملف	المسار المهني	المسميات المبحوث عنها
`paralegal_nyc.yaml`	القانون	مساعد قانوني، مساعد شؤون قانونية، أخصائي دعم التقاضي، سكرتير قانوني
`frontend_developer.yaml`	هندسة البرمجيات	مطور واجهات أمامية، مطور React، مهندس واجهة مستخدم
`tech_writer.yaml`	الكتابة التقنية	كاتب تقني، كاتب تجربة المستخدم، مصمم محتوى
`template_custom.yaml`	أي مسار مهني	مسميات نموذجية تستبدلها. كل إعداد له تعليق.

لاستخدام ملف جاهز، مرّر اسم ملفه عند تشغيل مسح:

الطرفية
sweepy --profile profiles/frontend_developer.yaml

تلميح

يمكنك إنشاء عدد غير محدود من الملفات التعريفية. خزّن ملفًا مختلفًا لكل تنويع في المسمى الوظيفي أو لكل مدينة تستهدفها. وانتقل بينها فورًا باستخدام المفتاح --profile.

الخيار ج: أتمت العمل بمساعد محادثة

يستطيع مساعد محادثة بناء الملفات التعريفية وتشغيل عمليات المسح لك. يتضمن Sweepy خادم بروتوكول سياق النموذج (MCP) مدمجًا، فيقرأ المساعد ملفاتك التعريفية ويكتب فيها مباشرة. يغطي دليل دمج MCP إعداد العميل على Antigravity وClaude Desktop وVS Code، ويسرد مرجع أدوات MCP كل أدوات Sweepy.

ابحث عن كل إعداد

يسرد مرجع التهيئة كل إعداد يقبله الملف التعريفي، من debug وresume.tracks إلى sources.* وreport.*. أبقِه مفتوحًا أثناء تحرير ملفك التعريفي.

تحقق من مصادر بحث Sweepy عن الوظائف

يستعلم Sweepy من أربعة أنظمة عامة لتتبع المتقدمين افتراضيًا. وتغطي هذه المجموعة Greenhouse وAshby وLever وWorkable. ويستعلم أيضًا من Built In NYC، وهي منصة وظائف في نيويورك. تعمل تغذيات المجمّعات من LinkedIn وIndeed وGlassdoor وZipRecruiter عبر python-jobspy عندما يمكّنها ملفك التعريفي.

تضيف المحركات الاختيارية منصات. والخيارات هي HireHunt وOpenRoles وJobDrop وApify. يتطلب OpenRoles قائمة شركات قبل أن يعمل. ويتطلب Apify وجود APIFY_TOKEN. ويتعارض JobDrop مع تثبيت تبعية JobSpy. يثبّتها خيار Download job engines في معالج الإعداد.

تغطي صفحة المصادر والمنصات المحركات الاختيارية وملفات البذور وإدخالات المنصات المخصصة وتحذيرات التوافق.

ملفك التعريفي جاهز. حان وقت تشغيل أول مسح لك.

الخيار أ: شغّل معالج الإعداد التفاعلي​

الخيار ب: حرّر ملف التهيئة يدويًا​

ملف أليكس التعريفي​

استخدام ملفات تعريفية جاهزة​

الخيار ج: أتمت العمل بمساعد محادثة​

ابحث عن كل إعداد​

تحقق من مصادر بحث Sweepy عن الوظائف​