این ابزار درست کار نمی‌کند؟

دربارهٔ ابزار «خواندن Open Graph آنلاین»

این ابزار یک URL را دریافت می‌کند و تگ‌های متای Open Graph (og:) آن را استخراج می‌کند — متادیتایی که Facebook، LinkedIn، Slack، iMessage، و سایر پلتفرم‌ها برای ساخت پیش‌نمایش پیوند استفاده می‌کنند. خروجی هر ویژگی og: که صفحه اعلام می‌کند را فهرست می‌کند، به علاوه تگ‌های Twitter Card به عنوان جایزه.

Open Graph تعیین می‌کند پیوند شما هنگام اشتراک‌گذاری چگونه به نظر می‌رسد: عنوان، توضیحات، تصویر پیش‌نمایش، نوع، و موارد دیگر. تگ‌های گمشده یا اشتباه پیش‌نمایش‌های زشت یا خالی تولید می‌کنند، که نرخ کلیک را آسیب می‌زند.

از آن برای تأیید اینکه صفحات خود متادیتای مورد نظر شما را دارند، اشکال‌زدایی پیش‌نمایشی که در یک پلتفرم خاص اشتباه به نظر می‌رسد، یا بازرسی نحوه ساختاردهی پیش‌نمایش‌های اشتراک‌گذاری رقیب استفاده کنید. Facebook Sharing Debugger و LinkedIn Post Inspector پیگیری‌های مفیدی برای اعتبارسنجی خاص پلتفرم هستند.

چطور از این ابزار استفاده کنم؟

چطور Open Graph و Twitter Card metadata را از HTML استخراج کنم؟

  1. HTML صفحه را بچسبانید

    HTML خام صفحه را در فیلد «HTML» قرار دهید. روی صفحه view-source کنید، بخش `<head>` (یا کل document) را کپی و paste کنید — ابزار فقط تگ‌های `<meta property="og:*">` و `<meta name="twitter:*">` را می‌خواند.

  2. «اجرا» را بزنید

    خروجی `og` (object با کلید بخش بعد از `og:`) و `twitter` (object با کلید بخش بعد از `twitter:`) را برمی‌گرداند. مثلاً `og:title` به `og.title` تبدیل می‌شود؛ `twitter:card` به `twitter.card`.

  3. آنچه fetch نمی‌کند

    ابزار HTML که شما ارائه می‌کنید را parse می‌کند — URLها را برای شما fetch نمی‌کند. برای fetching از یک ابزار URL-fetcher جداگانه استفاده و پاسخ را به این بدهید. CSP، bot block یا صفحات auth-gated اینجا ظاهر نمی‌شوند.

  4. تایید نتیجه

    همان HTML را با Facebook's Sharing Debugger (developers.facebook.com/tools/debug) یا Twitter Card Validator اجرا کنید تا ببینید پلتفرم‌ها چطور آن را رندر می‌کنند. تگ‌های parse-شده باید مطابقت داشته باشند.